> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coralogix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Acknowledge incidents

> Mark one or more incidents as acknowledged.

Requires the following permissions:
- `incidents:acknowledge`



## OpenAPI

````yaml openapi_v3.yaml post /incidents/incidents/v1/acknowledge
openapi: 3.0.0
info:
  title: ''
  version: 1.0.0
servers:
  - url: https://api.coralogix.com/mgmt/openapi/3
  - url: https://api.eu2.coralogix.com/mgmt/openapi/3
  - url: https://api.coralogix.us/mgmt/openapi/3
  - url: https://api.cx498.coralogix.com/mgmt/openapi/3
  - url: https://api.coralogix.in/mgmt/openapi/3
  - url: https://api.coralogixsg.com/mgmt/openapi/3
  - url: https://api.ap3.coralogix.com/mgmt/openapi/3
security:
  - apiKeyAuth: []
tags:
  - name: Alert definitions service
    description: >-
      View and manage your alerts using alert definitions - data structures that
      contain the configuration required to create an alert.
    externalDocs:
      description: Learn more about alerts in our documentation
      url: https://coralogix.com/docs/user-guides/alerting/introduction-to-alerts/
  - name: Metrics Data Archive Service
    description: View and manage your storage targets for metrics.
    externalDocs:
      description: Find out more about archives
      url: >-
        https://coralogix.com/docs/user-guides/data-flow/s3-archive/connect-s3-archive/
  - name: Connectors service
    description: >-
      View and manage your connectors - integration instances for notification
      destinations
    externalDocs:
      description: Lean more about connectors in our documentation
      url: >-
        https://coralogix.com/docs/user-guides/notification-center/connectors/introduction/
  - name: Cases service
    description: >-
      Manage cases throughout their lifecycle. Create, view, assign,
      acknowledge, resolve, and close cases to streamline investigations and
      follow-ups.
    externalDocs:
      description: Learn more about Cases in our documentation
      url: https://coralogix.com/docs/user-guides/cases/
  - name: SAML Configuration Service
    description: Manage your SAML configuration
    externalDocs:
      url: ''
  - name: Events2Metrics Service
    description: Manage your events2metrics.
    externalDocs:
      url: ''
  - name: Presets service
    description: >-
      View and manage your presets - pre-configured templates for notification
      content rendering
    externalDocs:
      description: Lean more about presets in our documentation
      url: >-
        https://coralogix.com/docs/user-guides/notification-center/presets/introduction/
  - name: Entities service
    description: Query information about registered entities in the notification center
    externalDocs:
      description: Lean more about the notification center in our documentation
      url: https://coralogix.com/docs/user-guides/notification-center/introduction/
  - name: API Keys Service
    description: Manage your API Keys.
    externalDocs:
      url: ''
  - name: Alert events service
    description: >-
      Get information regarding your alert events - instances of alerts being
      triggered.
    externalDocs:
      description: Learn more about alert events and incidents in our documentation.
      url: https://coralogix.com/docs/user-guides/alerting/incidents/
  - name: Scopes Service
    description: A service to manage scopes
    externalDocs:
      url: ''
  - name: IP access service
    description: >-
      IP access service provides the API for managing company IP access
      settings.
    externalDocs:
      url: ''
  - name: Dashboard service
    description: Get information about the Coralogix Dashboard catalog.
    externalDocs:
      url: ''
  - name: Events Service
    description: A service for querying events.
    externalDocs:
      description: Learn more about alerts in our documentation
      url: https://coralogix.com/docs/user-guides/alerting/introduction-to-alerts/
  - name: Team Permissions Management Service
    description: Manage Team Groups.
    externalDocs:
      url: ''
  - name: Extension service
    description: A service that enables querying for extension information.
    externalDocs:
      description: Learn more about extensions in our documentation.
      url: https://coralogix.com/docs/integrations/extensions/
  - name: Extension testing service
    externalDocs:
      description: Find out more about extensions in our documentation.
      url: https://coralogix.com/docs/integrations/extensions/
  - name: Data Usage Service
    description: A service to manage data usage metrics.
    externalDocs:
      url: ''
  - name: Target Service
    description: View and manage your storage targets for logs.
    externalDocs:
      description: Find out more about archives
      url: >-
        https://coralogix.com/docs/user-guides/data-flow/s3-archive/connect-s3-archive/
  - name: Contextual data integration service
    description: Query for contextual data integration information.
    externalDocs:
      url: ''
  - name: Custom Enrichments Service
    description: Manage your enrichments.
    externalDocs:
      url: ''
  - name: Global routers service
    description: >-
      View and manage your global routers - entities that direct notifications
      to configured destinations based on conditions
    externalDocs:
      description: Lean more about global routers in our documentation
      url: >-
        https://coralogix.com/docs/user-guides/notification-center/routing/introduction/
  - name: Recording Rules Service
    description: A service to manage recording rules.
    externalDocs:
      url: ''
  - name: Folders for views service
    description: Create and manage view folders.
    externalDocs:
      url: ''
  - name: Incidents service
    description: >-
      Handle all operations related to incident management within Coralogix.
      Identify, manage, and resolve incidents efficiently through automated
      workflows and team collaboration.
    externalDocs:
      description: Find out more about incident management in our documentation
      url: https://coralogix.com/docs/user-guides/alerting/incidents/
  - name: Retentions Service
    description: View and manage retentions
    externalDocs:
      url: ''
  - name: Extension deployment service
    description: A service that enables querying for extension deployment information.
    externalDocs:
      description: Find out more about extensions in our documentation.
      url: https://coralogix.com/docs/integrations/extensions/
  - name: Enrichments Service
    description: Manage your enrichments.
    externalDocs:
      url: ''
  - name: Role Management Service
    description: Service for managing system and custom roles.
    externalDocs:
      url: ''
  - name: Integration service
    description: A service that enables querying for integration information.
    externalDocs:
      description: Find out more about integrations in our documentation.
      url: https://coralogix.com/docs/integrations/getting-started/
  - name: Rule Groups Service
    description: A service to manage rule groups.
    externalDocs:
      url: ''
  - name: Policies Service
    description: View and manage your TCO policies
    externalDocs:
      url: ''
  - name: Alert Scheduler Rule service
    description: Manage your alert scheduler rules.
    externalDocs:
      url: ''
  - name: Dashboard folders service
    description: Manage your dashboard folders.
    externalDocs:
      url: ''
  - name: Actions Service
    description: A service for managing actions.
    externalDocs:
      url: ''
  - name: Slos Service
    description: A service for managing Service Level Objectives (SLOs).
    externalDocs:
      url: ''
  - name: Views service
    description: Create and manage views.
    externalDocs:
      url: ''
  - name: Outgoing webhooks service
    externalDocs:
      description: Find out more about outbound webhooks in our documentation.
      url: >-
        https://coralogix.com/docs/user-guides/alerting/outbound-webhooks/generic-outbound-webhooks-alert-webhooks/
  - name: SLO Service
    description: Manage your SLOs.
    externalDocs:
      url: ''
paths:
  /incidents/incidents/v1/acknowledge:
    post:
      tags:
        - Incidents service
      summary: Acknowledge incidents
      description: |-
        Mark one or more incidents as acknowledged.

        Requires the following permissions:
        - `incidents:acknowledge`
      operationId: IncidentsService_AcknowledgeIncidents
      parameters:
        - in: query
          name: incident_ids
          required: false
          schema:
            type: array
            items:
              type: string
              description: List of incident IDs to acknowledge
            example:
              - incident_id_1
              - incident_id_2
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AcknowledgeIncidentsResponse'
          description: ''
        '400':
          content:
            application/json: {}
          description: Bad Request
        '401':
          content:
            application/json: {}
          description: Unauthorized request
        '500':
          content:
            application/json: {}
          description: Internal server error
      externalDocs:
        url: ''
components:
  schemas:
    AcknowledgeIncidentsResponse:
      title: Acknowledge incidents response
      required:
        - incidents
      type: object
      properties:
        incidents:
          type: array
          items:
            $ref: '#/components/schemas/Incident'
      description: Response containing the updated incidents after acknowledgment
      externalDocs:
        url: ''
    Incident:
      title: Incident
      required:
        - id
        - state
        - status
        - assignments
        - severity
        - contextualLabels
        - displayLabels
        - events
        - createdAt
        - lastStateUpdateTime
        - lastStateUpdateKey
        - duration
      type: object
      properties:
        assignments:
          type: array
          items:
            $ref: '#/components/schemas/Assignment'
        closedAt:
          type: string
          format: date-time
          example: '2024-01-01T00:00:00.000Z'
        contextualLabels:
          type: object
          additionalProperties:
            type: string
        createdAt:
          type: string
          format: date-time
          example: '2024-01-01T00:00:00.000Z'
        description:
          type: string
          example: incident_description
        displayLabels:
          type: object
          additionalProperties:
            type: string
        duration:
          type: string
        events:
          type: array
          items:
            $ref: '#/components/schemas/IncidentEvent'
        id:
          type: string
          example: incident_id
        isMuted:
          type: boolean
          example: false
        lastStateUpdateKey:
          type: string
          example: last_state_update_key
        lastStateUpdateTime:
          type: string
          format: date-time
          example: '2024-01-01T00:00:00.000Z'
        metaLabels:
          type: array
          items:
            $ref: '#/components/schemas/incidents.v1.MetaLabel'
        name:
          type: string
          example: incident_name
        severity:
          $ref: '#/components/schemas/IncidentSeverity'
        state:
          $ref: '#/components/schemas/IncidentState'
        status:
          $ref: '#/components/schemas/IncidentStatus'
      externalDocs:
        url: ''
    Assignment:
      title: Assignment
      required:
        - assignedTo
        - assignedBy
      type: object
      properties:
        assignedBy:
          $ref: '#/components/schemas/incidents.v1.UserDetails'
        assignedTo:
          $ref: '#/components/schemas/incidents.v1.UserDetails'
      description: >-
        Details of the user who assigned the incident and the user to whom it
        was assigned
      externalDocs:
        url: ''
    IncidentEvent:
      oneOf:
        - $ref: '#/components/schemas/IncidentEventAcknowledgeOperationalEvent'
        - $ref: '#/components/schemas/IncidentEventSnoozeIndicatorAdministrativeEvent'
        - $ref: '#/components/schemas/IncidentEventAssignmentOperationalEvent'
        - $ref: '#/components/schemas/IncidentEventUnassignOperationalEvent'
        - $ref: '#/components/schemas/IncidentEventUpsertStateAdministrativeEvent'
        - $ref: '#/components/schemas/IncidentEventAcknowledgeAdministrativeEvent'
        - $ref: '#/components/schemas/IncidentEventCloseAdministrativeEvent'
        - $ref: '#/components/schemas/IncidentEventCloseOperationalEvent'
        - $ref: '#/components/schemas/IncidentEventSnoozeIndicatorOperationalEvent'
        - $ref: '#/components/schemas/IncidentEventAssignmentAdministrativeEvent'
        - $ref: '#/components/schemas/IncidentEventUnassignAdministrativeEvent'
        - $ref: '#/components/schemas/IncidentEventUpsertStateOperationalEvent'
    incidents.v1.MetaLabel:
      title: Incident meta label
      type: object
      properties:
        key:
          type: string
          example: key
        value:
          type: string
          example: value
      externalDocs:
        url: ''
    IncidentSeverity:
      enum:
        - INCIDENT_SEVERITY_UNSPECIFIED
        - INCIDENT_SEVERITY_INFO
        - INCIDENT_SEVERITY_WARNING
        - INCIDENT_SEVERITY_ERROR
        - INCIDENT_SEVERITY_CRITICAL
        - INCIDENT_SEVERITY_LOW
      type: string
    IncidentState:
      enum:
        - INCIDENT_STATE_UNSPECIFIED
        - INCIDENT_STATE_TRIGGERED
        - INCIDENT_STATE_RESOLVED
      type: string
    IncidentStatus:
      enum:
        - INCIDENT_STATUS_UNSPECIFIED
        - INCIDENT_STATUS_TRIGGERED
        - INCIDENT_STATUS_ACKNOWLEDGED
        - INCIDENT_STATUS_RESOLVED
      type: string
    incidents.v1.UserDetails:
      title: User details
      required:
        - userId
      type: object
      properties:
        userId:
          type: string
          example: user_id
      externalDocs:
        url: ''
    IncidentEventAcknowledgeOperationalEvent:
      title: Incident event
      required:
        - id
        - incidentEventType
        - originatorType
        - originator
        - incidentEventPayload
      type: object
      properties:
        acknowledge:
          $ref: '#/components/schemas/IncidentEventAcknowledge'
        id:
          type: string
          description: The ID of the incident event
          example: incident_event_id
        incidentEventType:
          $ref: '#/components/schemas/IncidentEventType'
        operationalEvent:
          $ref: '#/components/schemas/IncidentEventOriginatorOperational'
        originatorType:
          $ref: '#/components/schemas/OriginatorType'
      additionalProperties: false
      externalDocs:
        url: ''
    IncidentEventSnoozeIndicatorAdministrativeEvent:
      title: Incident event
      required:
        - id
        - incidentEventType
        - originatorType
        - originator
        - incidentEventPayload
      type: object
      properties:
        administrativeEvent:
          $ref: '#/components/schemas/IncidentEventOriginatorAdministrative'
        id:
          type: string
          description: The ID of the incident event
          example: incident_event_id
        incidentEventType:
          $ref: '#/components/schemas/IncidentEventType'
        originatorType:
          $ref: '#/components/schemas/OriginatorType'
        snoozeIndicator:
          $ref: '#/components/schemas/IncidentEventSnoozeIndicator'
      additionalProperties: false
      externalDocs:
        url: ''
    IncidentEventAssignmentOperationalEvent:
      title: Incident event
      required:
        - id
        - incidentEventType
        - originatorType
        - originator
        - incidentEventPayload
      type: object
      properties:
        assignment:
          $ref: '#/components/schemas/IncidentEventAssign'
        id:
          type: string
          description: The ID of the incident event
          example: incident_event_id
        incidentEventType:
          $ref: '#/components/schemas/IncidentEventType'
        operationalEvent:
          $ref: '#/components/schemas/IncidentEventOriginatorOperational'
        originatorType:
          $ref: '#/components/schemas/OriginatorType'
      additionalProperties: false
      externalDocs:
        url: ''
    IncidentEventUnassignOperationalEvent:
      title: Incident event
      required:
        - id
        - incidentEventType
        - originatorType
        - originator
        - incidentEventPayload
      type: object
      properties:
        id:
          type: string
          description: The ID of the incident event
          example: incident_event_id
        incidentEventType:
          $ref: '#/components/schemas/IncidentEventType'
        operationalEvent:
          $ref: '#/components/schemas/IncidentEventOriginatorOperational'
        originatorType:
          $ref: '#/components/schemas/OriginatorType'
        unassign:
          $ref: '#/components/schemas/IncidentEventUnassign'
      additionalProperties: false
      externalDocs:
        url: ''
    IncidentEventUpsertStateAdministrativeEvent:
      title: Incident event
      required:
        - id
        - incidentEventType
        - originatorType
        - originator
        - incidentEventPayload
      type: object
      properties:
        administrativeEvent:
          $ref: '#/components/schemas/IncidentEventOriginatorAdministrative'
        id:
          type: string
          description: The ID of the incident event
          example: incident_event_id
        incidentEventType:
          $ref: '#/components/schemas/IncidentEventType'
        originatorType:
          $ref: '#/components/schemas/OriginatorType'
        upsertState:
          $ref: '#/components/schemas/IncidentEventUpsertState'
      additionalProperties: false
      externalDocs:
        url: ''
    IncidentEventAcknowledgeAdministrativeEvent:
      title: Incident event
      required:
        - id
        - incidentEventType
        - originatorType
        - originator
        - incidentEventPayload
      type: object
      properties:
        acknowledge:
          $ref: '#/components/schemas/IncidentEventAcknowledge'
        administrativeEvent:
          $ref: '#/components/schemas/IncidentEventOriginatorAdministrative'
        id:
          type: string
          description: The ID of the incident event
          example: incident_event_id
        incidentEventType:
          $ref: '#/components/schemas/IncidentEventType'
        originatorType:
          $ref: '#/components/schemas/OriginatorType'
      additionalProperties: false
      externalDocs:
        url: ''
    IncidentEventCloseAdministrativeEvent:
      title: Incident event
      required:
        - id
        - incidentEventType
        - originatorType
        - originator
        - incidentEventPayload
      type: object
      properties:
        administrativeEvent:
          $ref: '#/components/schemas/IncidentEventOriginatorAdministrative'
        close:
          $ref: '#/components/schemas/IncidentEventClose'
        id:
          type: string
          description: The ID of the incident event
          example: incident_event_id
        incidentEventType:
          $ref: '#/components/schemas/IncidentEventType'
        originatorType:
          $ref: '#/components/schemas/OriginatorType'
      additionalProperties: false
      externalDocs:
        url: ''
    IncidentEventCloseOperationalEvent:
      title: Incident event
      required:
        - id
        - incidentEventType
        - originatorType
        - originator
        - incidentEventPayload
      type: object
      properties:
        close:
          $ref: '#/components/schemas/IncidentEventClose'
        id:
          type: string
          description: The ID of the incident event
          example: incident_event_id
        incidentEventType:
          $ref: '#/components/schemas/IncidentEventType'
        operationalEvent:
          $ref: '#/components/schemas/IncidentEventOriginatorOperational'
        originatorType:
          $ref: '#/components/schemas/OriginatorType'
      additionalProperties: false
      externalDocs:
        url: ''
    IncidentEventSnoozeIndicatorOperationalEvent:
      title: Incident event
      required:
        - id
        - incidentEventType
        - originatorType
        - originator
        - incidentEventPayload
      type: object
      properties:
        id:
          type: string
          description: The ID of the incident event
          example: incident_event_id
        incidentEventType:
          $ref: '#/components/schemas/IncidentEventType'
        operationalEvent:
          $ref: '#/components/schemas/IncidentEventOriginatorOperational'
        originatorType:
          $ref: '#/components/schemas/OriginatorType'
        snoozeIndicator:
          $ref: '#/components/schemas/IncidentEventSnoozeIndicator'
      additionalProperties: false
      externalDocs:
        url: ''
    IncidentEventAssignmentAdministrativeEvent:
      title: Incident event
      required:
        - id
        - incidentEventType
        - originatorType
        - originator
        - incidentEventPayload
      type: object
      properties:
        administrativeEvent:
          $ref: '#/components/schemas/IncidentEventOriginatorAdministrative'
        assignment:
          $ref: '#/components/schemas/IncidentEventAssign'
        id:
          type: string
          description: The ID of the incident event
          example: incident_event_id
        incidentEventType:
          $ref: '#/components/schemas/IncidentEventType'
        originatorType:
          $ref: '#/components/schemas/OriginatorType'
      additionalProperties: false
      externalDocs:
        url: ''
    IncidentEventUnassignAdministrativeEvent:
      title: Incident event
      required:
        - id
        - incidentEventType
        - originatorType
        - originator
        - incidentEventPayload
      type: object
      properties:
        administrativeEvent:
          $ref: '#/components/schemas/IncidentEventOriginatorAdministrative'
        id:
          type: string
          description: The ID of the incident event
          example: incident_event_id
        incidentEventType:
          $ref: '#/components/schemas/IncidentEventType'
        originatorType:
          $ref: '#/components/schemas/OriginatorType'
        unassign:
          $ref: '#/components/schemas/IncidentEventUnassign'
      additionalProperties: false
      externalDocs:
        url: ''
    IncidentEventUpsertStateOperationalEvent:
      title: Incident event
      required:
        - id
        - incidentEventType
        - originatorType
        - originator
        - incidentEventPayload
      type: object
      properties:
        id:
          type: string
          description: The ID of the incident event
          example: incident_event_id
        incidentEventType:
          $ref: '#/components/schemas/IncidentEventType'
        operationalEvent:
          $ref: '#/components/schemas/IncidentEventOriginatorOperational'
        originatorType:
          $ref: '#/components/schemas/OriginatorType'
        upsertState:
          $ref: '#/components/schemas/IncidentEventUpsertState'
      additionalProperties: false
      externalDocs:
        url: ''
    IncidentEventAcknowledge:
      type: object
      properties:
        acknowledgedBy:
          $ref: '#/components/schemas/incidents.v1.UserDetails'
    IncidentEventType:
      enum:
        - INCIDENT_EVENT_TYPE_UNSPECIFIED
        - INCIDENT_EVENT_TYPE_UPSERT_STATE
        - INCIDENT_EVENT_TYPE_OPEN
        - INCIDENT_EVENT_TYPE_CLOSE
        - INCIDENT_EVENT_TYPE_SNOOZE_INDICATOR
        - INCIDENT_EVENT_TYPE_ASSIGN
        - INCIDENT_EVENT_TYPE_UNASSIGN
        - INCIDENT_EVENT_TYPE_ACKNOWLEDGE
      type: string
    IncidentEventOriginatorOperational:
      type: object
      properties:
        systemName:
          type: string
    OriginatorType:
      enum:
        - ORIGINATOR_TYPE_UNSPECIFIED
        - ORIGINATOR_TYPE_OPERATIONAL
        - ORIGINATOR_TYPE_ADMINISTRATIVE
      type: string
    IncidentEventOriginatorAdministrative:
      type: object
      properties:
        userId:
          type: string
    IncidentEventSnoozeIndicator:
      title: Incident event snooze indicator
      type: object
      properties:
        durationMinutes:
          type: integer
          format: int32
        startTime:
          type: string
          format: date-time
        userId:
          type: string
      externalDocs:
        url: ''
    IncidentEventAssign:
      title: Incident event assignment details
      type: object
      properties:
        assignment:
          $ref: '#/components/schemas/Assignment'
      externalDocs:
        url: ''
    IncidentEventUnassign:
      type: object
    IncidentEventUpsertState:
      title: Incident event upsert state
      required:
        - stateType
        - payload
      type: object
      properties:
        isMuted:
          type: boolean
        payload:
          $ref: '#/components/schemas/UpsertIncidentStatePayload'
        stateType:
          $ref: '#/components/schemas/UpsertIncidentStateType'
      externalDocs:
        url: ''
    IncidentEventClose:
      type: object
      properties:
        closedBy:
          $ref: '#/components/schemas/incidents.v1.UserDetails'
    UpsertIncidentStatePayload:
      type: object
      properties:
        cxEventKey:
          type: string
    UpsertIncidentStateType:
      enum:
        - UPSERT_INCIDENT_STATE_TYPE_UNSPECIFIED
        - UPSERT_INCIDENT_STATE_TYPE_TRIGGERED
        - UPSERT_INCIDENT_STATE_TYPE_RESOLVED
      type: string
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: API key authentication

````