> For the complete documentation index, see [llms.txt](https://developers.incidents.cloud.solarwinds.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.incidents.cloud.solarwinds.com/org-scoped-api-reference/incidents.md).

# Incidents

## Bulk Acknowledge Incidents

> Acknowledges multiple incidents in a single operation.\
> Maximum 20 incidents can be acknowledged per request.\
> Returns success and failure details for each incident.\
> \
> Requires \`incidents:write\` permission.

```json
{"openapi":"3.1.0","info":{"title":"Squadcast Organization-Scoped Public APIs","version":"2024-08-11"},"tags":[{"name":"Incidents"}],"servers":[{"url":"https://api.eu.squadcast.com","description":"production EU env","variables":{}},{"url":"https://api.squadcast.com","description":"production US env","variables":{}}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"Common.V4.BulkMeta":{"type":"object","required":["total","success","failed"],"properties":{"total":{"type":"integer","format":"int32"},"success":{"type":"integer","format":"int32"},"failed":{"type":"integer","format":"int32"}},"description":"Metadata for bulk operation responses"},"Incidents.BulkAcknowledgeSuccess":{"type":"object","required":["id","message"],"properties":{"id":{"type":"string","description":"The incident ID that was successfully acknowledged."},"message":{"type":"string","description":"Success message."}},"description":"Success item in a bulk acknowledge operation."},"Incidents.BulkAcknowledgeError":{"type":"object","required":["id","error"],"properties":{"id":{"type":"string","description":"The incident ID that failed to acknowledge."},"error":{"type":"string","description":"Error message describing why the operation failed."}},"description":"Error item in a bulk acknowledge operation."},"Incidents.BulkAcknowledgeRequest":{"type":"object","required":["incidentIDs"],"properties":{"incidentIDs":{"type":"array","items":{"type":"string"},"maxItems":20,"description":"Array of incident IDs to acknowledge (max 20 items)."}},"description":"Request body for bulk acknowledging incidents."}}},"paths":{"/v4/public/incidents/acknowledge":{"post":{"operationId":"IncidentOperations_bulkAcknowledgeIncidents","summary":"Bulk Acknowledge Incidents","description":"Acknowledges multiple incidents in a single operation.\nMaximum 20 incidents can be acknowledged per request.\nReturns success and failure details for each incident.\n\nRequires `incidents:write` permission.","parameters":[],"responses":{"200":{"description":"Bulk response with success and error items","content":{"application/json":{"schema":{"type":"object","required":["meta","data","errors"],"properties":{"meta":{"$ref":"#/components/schemas/Common.V4.BulkMeta"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Incidents.BulkAcknowledgeSuccess"}},"errors":{"type":"array","items":{"$ref":"#/components/schemas/Incidents.BulkAcknowledgeError"}}},"description":"Generic response for bulk operations with success and error items"}}}}},"tags":["Incidents"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Incidents.BulkAcknowledgeRequest"}}},"description":"Request containing array of incident IDs"}}}}}
```

## List Incidents By IDs

> Retrieves detailed information for a list of incidents in the organization.\
> Maximum 50 incidents can be fetched in a single request.\
> \
> Requires \`incidents:read\` permission.

```json
{"openapi":"3.1.0","info":{"title":"Squadcast Organization-Scoped Public APIs","version":"2024-08-11"},"tags":[{"name":"Incidents"}],"servers":[{"url":"https://api.eu.squadcast.com","description":"production EU env","variables":{}},{"url":"https://api.squadcast.com","description":"production US env","variables":{}}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"Incidents.BaseIncident":{"type":"object","required":["id","status","assignedTo","createdAt","updatedAt"],"properties":{"id":{"type":"string","description":"The unique identifier of the incident."},"status":{"type":"string","description":"The current status of the incident."},"assignedTo":{"allOf":[{"$ref":"#/components/schemas/Incidents.AssignedTo"}],"description":"The entity currently assigned to the incident."},"createdAt":{"type":"string","format":"date-time","description":"The timestamp when the incident was created."},"updatedAt":{"type":"string","format":"date-time","description":"The timestamp when the incident was last updated."}},"description":"Represents a basic incident in the organization-scoped API."},"Incidents.AssignedTo":{"type":"object","required":["id","name","type"],"properties":{"id":{"type":"string","description":"The ID of the assigned entity."},"name":{"type":"string","description":"The name of the assigned entity."},"type":{"type":"string","enum":["user","squad","escalationpolicy"],"description":"The type of the assigned entity (user, squad, or escalationpolicy)."}},"description":"Represents an entity that an incident is assigned to."},"Incidents.ListIncidentsByIDsRequest":{"type":"object","required":["incidentIDs"],"properties":{"incidentIDs":{"type":"array","items":{"type":"string"},"maxItems":50,"description":"Array of incident IDs to fetch (max 50 items)."}},"description":"Request body for listing incidents by IDs."}}},"paths":{"/v4/public/incidents/ids":{"post":{"operationId":"IncidentOperations_listIncidentsByIDs","summary":"List Incidents By IDs","description":"Retrieves detailed information for a list of incidents in the organization.\nMaximum 50 incidents can be fetched in a single request.\n\nRequires `incidents:read` permission.","parameters":[],"responses":{"200":{"description":"Array of incident details","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Incidents.BaseIncident"}}}}}},"tags":["Incidents"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Incidents.ListIncidentsByIDsRequest"}}},"description":"Request containing array of incident IDs"}}}}}
```

## Bulk Reassign Incidents

> Reassigns multiple incidents to a specified user or squad in a single operation.\
> Maximum 20 incidents can be reassigned per request.\
> Returns success and failure details for each incident.\
> \
> Requires \`incidents:write\` permission.

```json
{"openapi":"3.1.0","info":{"title":"Squadcast Organization-Scoped Public APIs","version":"2024-08-11"},"tags":[{"name":"Incidents"}],"servers":[{"url":"https://api.eu.squadcast.com","description":"production EU env","variables":{}},{"url":"https://api.squadcast.com","description":"production US env","variables":{}}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"Common.V4.BulkMeta":{"type":"object","required":["total","success","failed"],"properties":{"total":{"type":"integer","format":"int32"},"success":{"type":"integer","format":"int32"},"failed":{"type":"integer","format":"int32"}},"description":"Metadata for bulk operation responses"},"Incidents.BulkReassignSuccess":{"type":"object","required":["id","message"],"properties":{"id":{"type":"string","description":"The incident ID that was successfully reassigned."},"message":{"type":"string","description":"Success message."}},"description":"Success item in a bulk reassign operation."},"Incidents.BulkReassignError":{"type":"object","required":["id","error"],"properties":{"id":{"type":"string","description":"The incident ID that failed to reassign."},"error":{"type":"string","description":"Error message describing why the operation failed."}},"description":"Error item in a bulk reassign operation."},"Incidents.BulkReassignRequest":{"type":"object","required":["incidentIDs","reassignToID","reassignToType"],"properties":{"incidentIDs":{"type":"array","items":{"type":"string"},"maxItems":20,"description":"Array of incident IDs to reassign (max 20 items)."},"reassignToID":{"type":"string","description":"The ID of the entity to reassign incidents to."},"reassignToType":{"type":"string","enum":["user","squad"],"description":"The type of entity to reassign to (user or squad)."}},"description":"Request body for bulk reassigning incidents."}}},"paths":{"/v4/public/incidents/reassign":{"post":{"operationId":"IncidentOperations_bulkReassignIncidents","summary":"Bulk Reassign Incidents","description":"Reassigns multiple incidents to a specified user or squad in a single operation.\nMaximum 20 incidents can be reassigned per request.\nReturns success and failure details for each incident.\n\nRequires `incidents:write` permission.","parameters":[],"responses":{"200":{"description":"Bulk response with success and error items","content":{"application/json":{"schema":{"type":"object","required":["meta","data","errors"],"properties":{"meta":{"$ref":"#/components/schemas/Common.V4.BulkMeta"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Incidents.BulkReassignSuccess"}},"errors":{"type":"array","items":{"$ref":"#/components/schemas/Incidents.BulkReassignError"}}},"description":"Generic response for bulk operations with success and error items"}}}}},"tags":["Incidents"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Incidents.BulkReassignRequest"}}},"description":"Request containing incident IDs and reassignment target"}}}}}
```