> 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"}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.incidents.cloud.solarwinds.com/org-scoped-api-reference/incidents.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.