> ## Documentation Index > Fetch the complete documentation index at: https://docs.corbado.com/llms.txt > Use this file to discover all available pages before exploring further. # Update alert contact point > Replaces the contact point and its integration set. An integration listed with an id keeps that id; one listed without an id is created; one that is no longer listed is retired, not erased, so the delivery history that references it still resolves. Required API key permission: `observe:alerts:write`. ## OpenAPI ````yaml /api-reference/openapi/observe.yaml put /observe/alertContactPoints/{alertContactPointID} openapi: 3.1.1 info: version: 1.0.0 title: Corbado API description: > # Introduction This documentation gives an overview of all Corbado API calls to implement authentication observe. contact: name: Corbado team email: support@corbado.com url: https://www.corbado.com servers: - url: https://api.cloud.corbado.io/v1 security: - bearerAuth: [] tags: - name: ObserveFlow description: Flow search and related APIs x-group: Journeys and users - name: ObserveSubFlow description: Subflow search and related APIs x-group: Journeys and users - name: ObserveUser description: User search and related APIs x-group: Journeys and users - name: ObserveClientEnv description: Client environment search APIs x-group: Journeys and users - name: ObserveTimeSeries description: Time series query APIs x-group: Metrics and funnels - name: ObserveFunnel description: Historical funnel metrics, dictionaries and coverage. x-group: Metrics and funnels - name: ObserveEvent description: Event ingestion and event feed APIs x-group: Events - name: ObserveError description: Named authentication errors and recommendations. x-group: Error management - name: ObserveErrorFlavour description: Error variants and their impact on authentication outcomes. x-group: Error management - name: ObserveAlert description: Authentication alert rules, instances and history. x-group: Alert management - name: ObserveAnnotation description: Annotation APIs (dated notes for analytics context) x-group: Annotations - name: ObserveTableExport description: Table export file listing and download APIs x-group: Data exports - name: ObserveTimeSeriesExport description: Time-series export generation and downloads. x-group: Data exports - name: ObserveDataExport description: Data export APIs x-group: User data - name: ObserveDataDeletionJob description: Data deletion job APIs x-group: User data - name: ObserveFlowTypeDefinition description: Flow type definitions used in authentication journeys. x-group: Catalogs and labels - name: ObserveCatalog description: Catalog APIs x-group: Catalogs and labels - name: OpenAPI description: Downloadable API specification - name: ProjectOperationExecution description: Project-scoped operation history and pipeline health - name: ObserveClassification description: Flow and subflow classification APIs - name: ObserveIntegrationStats description: Integration stats APIs - name: ObserveTimeSeriesPrecalculation description: Time series precalculation APIs - name: ObserveIDList x-group: Saved ID lists description: Stored ID-list selection APIs - name: ObserveDataContext description: Schema-loose data context APIs for agent and debugging tooling - name: ObserveData description: Observe data administration APIs - name: ObserveTrackingStats description: Tracking ingestion stats APIs - name: ObserveExperiment x-group: Experiments description: Experiment catalog and run APIs - name: ObserveDataPolicy description: >- Project data policy catalogue (retention selected by the SDK's meta.dataPolicy code) - name: ObserveMetadata x-group: Metadata description: Authenticator metadata APIs (FIDO MDS + passkey AAGUID) - name: ObservePasskey x-group: Passkey analysis description: Observed passkey search and cohort analysis. paths: /observe/alertContactPoints/{alertContactPointID}: put: tags: - ObserveAlert summary: Update alert contact point description: >- Replaces the contact point and its integration set. An integration listed with an id keeps that id; one listed without an id is created; one that is no longer listed is retired, not erased, so the delivery history that references it still resolves. Required API key permission: `observe:alerts:write`. operationId: ObserveAlertContactPointUpdate parameters: - name: alertContactPointID in: path required: true description: Alert contact point ID (format `acp-`). schema: type: string x-oapi-codegen-extra-tags: validate: required,id=acp requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/observeAlertContactPointUpdateReq' responses: '200': description: Contact point updated. content: application/json: schema: $ref: '#/components/schemas/observeAlertContactPoint' default: $ref: '#/components/responses/error' security: - bearerAuth: - observe:alerts:write components: schemas: observeAlertContactPointUpdateReq: type: object required: - name - integrations properties: name: type: string x-oapi-codegen-extra-tags: validate: required,min=1,max=255 description: type: string x-oapi-codegen-extra-tags: validate: omitempty,min=1,max=2000 integrations: type: array minItems: 1 maxItems: 100 items: $ref: '#/components/schemas/observeAlertContactPointIntegrationReq' x-oapi-codegen-extra-tags: validate: required,min=1,dive observeAlertContactPoint: type: object required: - id - name - integrations - createdMs - updatedMs properties: id: type: string description: Alert contact point ID (format `acp-`). name: type: string description: type: string integrations: type: array maxItems: 100 items: $ref: '#/components/schemas/observeAlertContactPointIntegration' createdMs: type: integer format: int64 updatedMs: type: integer format: int64 observeAlertContactPointIntegrationReq: type: object required: - type - settings properties: id: type: string description: >- Integration ID (format `aci-`). Omit to create a new integration; supply it to keep an existing one. x-oapi-codegen-extra-tags: validate: omitempty,id=aci type: type: string enum: - email x-oapi-codegen-extra-tags: validate: required,oneof=email settings: type: object additionalProperties: true description: >- Settings belonging to type. For email this is observeAlertContactPointIntegrationSettingsEmail. x-oapi-codegen-extra-tags: validate: required minSeverity: type: string enum: - info - warning - critical x-oapi-codegen-extra-tags: validate: omitempty,oneof=info warning critical status: type: string enum: - active - paused x-oapi-codegen-extra-tags: validate: omitempty,oneof=active paused observeAlertContactPointIntegration: type: object required: - id - type - settings - status properties: id: type: string description: Integration ID (format `aci-`). type: type: string enum: - email description: >- The delivery mechanism. Same vocabulary as an alert notification's channel. settings: type: object additionalProperties: true description: > Settings belonging to type. For email this is observeAlertContactPointIntegrationSettingsEmail and nothing else - the mail server, its credentials and the sender address belong to the deployment, not to the project. minSeverity: type: string enum: - info - warning - critical description: > Suppresses anything less severe than this level. Omit for no floor. Resolved notifications are always delivered regardless, so an integration that heard about a problem also hears that it is over. status: type: string enum: - active - paused errorRspV2: type: object required: - error properties: error: type: object required: - message properties: message: description: Error message type: string example: Validation failed details: description: Validation error details per field type: array items: type: object required: - field - message properties: field: description: Field name that failed validation type: string example: projectID message: description: Validation error message type: string example: required responses: error: description: Error content: application/json: schema: $ref: '#/components/schemas/errorRspV2' securitySchemes: bearerAuth: type: http scheme: bearer description: >- Use an Observe API key from the management console. The key selects the project and must grant the permission listed on the operation. Keep this key on your server. ````