Note: This endpoint is in preview and is subject to change.
If you have any feedback, contact Datadog support.
GET https://api.ap1.datadoghq.com/api/v2/incidents/{incident_id}/respondershttps://api.ap2.datadoghq.com/api/v2/incidents/{incident_id}/respondershttps://api.datadoghq.eu/api/v2/incidents/{incident_id}/respondershttps://api.ddog-gov.com/api/v2/incidents/{incident_id}/respondershttps://api.us2.ddog-gov.com/api/v2/incidents/{incident_id}/respondershttps://api.uk1.datadoghq.com/api/v2/incidents/{incident_id}/respondershttps://api.datadoghq.com/api/v2/incidents/{incident_id}/respondershttps://api.us3.datadoghq.com/api/v2/incidents/{incident_id}/respondershttps://api.us5.datadoghq.com/api/v2/incidents/{incident_id}/responders
Overview
List all responders for an incident.
This endpoint requires the incident_read permission.
OAuth apps require the incident_read authorization scope to access this endpoint.
Arguments
Path Parameters
The UUID of the incident.
Response
OK
Response with a list of incident responders.
Expand All
List of incident responders.
Attributes of an incident responder in a response.
Timestamp when the responder was created.
The external ID of the responder.
The external source of the responder.
Whether this responder counts toward billing.
Timestamp when the responder was last active.
Additional metadata for the responder.
Timestamp when the responder was last modified.
The responder identifier.
Relationships for an incident responder.
Relationship to user object.
A unique identifier that represents the user.
Users resource type.
Allowed enum values: users
default: users
Relationship to user object.
A unique identifier that represents the user.
Users resource type.
Allowed enum values: users
default: users
Relationship to role assignments for a responder.
List of role assignment relationship data.
The role assignment identifier.
The role assignment resource type.
Relationship to user object.
A unique identifier that represents the user.
Users resource type.
Allowed enum values: users
default: users
Incident responder resource type.
Allowed enum values: incident_responders
Included related resources.
Attributes of user object returned by the API.
Users resource type.
Allowed enum values: users
default: users
{
"data": [
{
"attributes": {
"created": "2024-01-01T00:00:00.000Z",
"external_id": null,
"external_source": null,
"is_billable": true,
"last_active": "2024-01-01T00:00:00.000Z",
"meta": {},
"modified": "2024-01-01T00:00:00.000Z"
},
"id": "00000000-0000-0000-0000-000000000000",
"relationships": {
"created_by": {
"data": {
"id": "00000000-0000-0000-2345-000000000000",
"type": "users"
}
},
"last_modified_by": {
"data": {
"id": "00000000-0000-0000-2345-000000000000",
"type": "users"
}
},
"role_assignments": {
"data": [
{
"id": "00000000-0000-0000-0000-000000000000",
"type": "incident_role_assignments"
}
]
},
"user": {
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"type": "users"
}
}
},
"type": "incident_responders"
}
],
"included": [
{
"attributes": {
"email": "string",
"handle": "string",
"icon": "string",
"name": "string",
"uuid": "string"
},
"id": "string",
"type": "users"
}
]
}
Bad Request
{
"errors": [
"Bad Request"
]
}
Unauthorized
{
"errors": [
"Bad Request"
]
}
Forbidden
{
"errors": [
"Bad Request"
]
}
Not Found
{
"errors": [
"Bad Request"
]
}
Too many requests
{
"errors": [
"Bad Request"
]
}
Code Example
# Path parameters
export incident_id="CHANGE_ME"
# Curl command
curl -X GET "https://api.ap1.datadoghq.com"https://api.ap2.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.us2.ddog-gov.com"https://api.uk1.datadoghq.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/incidents/${incident_id}/responders" \
-H "Accept: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"
