latestOpenAPI 3.0.22026-07-144652931.4 MB

b679a8f3f02c

Incidents

Create a responder request for an incident

Send a new responder request for the specified incident. This endpoint requires the account to have access to the responder requests feature.

Account Ability Requirement: The account must have the coordinated_responding ability. Returns 402 Payment Required if the ability is missing. You can use the List Abilities API to check account abilities.

A user or an escalation policy can be requested. The responder targets will be notified via their high urgency notification rules, until the target user has either accepted or declined the request. Previous responder requests for a given target can be cancelled (preventing them from further notifying or escalating), with the Cancel Responder Requests endpoint.

Scoped OAuth requires: incidents.write

post/incidents/{id}/responder_requests

Path parameters

idstring required

The ID of the resource.

Headers

Acceptstring required

The Accept header is used as a versioning header.

Content-Type'application/json' required

Request body

requester_idstring required

The user id of the requester.

messagestring required

The message sent with the responder request.

Response

The new responder request for the given incident.

responder_requestResponderRequest required— unresolved $ref