ListIncidentAttachments
Retrieve all attachments for a specific incident by providing its UUID, with options to filter by attachment type and include related resources in the response. Simplifies access to critical incident data within Datadog’s observability platform.
Instructions
Get all attachments for a given incident.
Path Parameters:
incident_id (Required): The UUID of the incident.
Query Parameters:
include: Specifies which types of related objects are included in the response.
filter[attachment_type]: Specifies which types of attachments are included in the response.
Responses:
200 (Success): OK
Content-Type:
application/jsonResponse Properties:
data: An array of incident attachments.
included: Included related resources that the user requested.
Example:
{
"data": [
{
"attributes": {
"attachment": {
"documentUrl": "",
"title": "Postmortem IR-123"
},
"attachment_type": "postmortem"
},
"id": "00000000-abcd-0002-0000-000000000000",
"relationships": {
"last_modified_by_user": {
"data": {
"id": "00000000-0000-0000-cccc-000000000000",
"type": "users"
}
}
},
"type": "incident_attachments"
}
],
"included": [
"unknown_type"
]
}400: Bad Request
Content-Type:
application/jsonResponse Properties:
errors: A list of errors.
Example:
{
"errors": [
"Bad Request"
]
}401: Unauthorized
Content-Type:
application/jsonResponse Properties:
errors: A list of errors.
Example:
{
"errors": [
"Bad Request"
]
}403: Forbidden
Content-Type:
application/jsonResponse Properties:
errors: A list of errors.
Example:
{
"errors": [
"Bad Request"
]
}404: Not Found
Content-Type:
application/jsonResponse Properties:
errors: A list of errors.
Example:
{
"errors": [
"Bad Request"
]
}429: Too many requests
Content-Type:
application/jsonResponse Properties:
errors: A list of errors.
Example:
{
"errors": [
"Bad Request"
]
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filter[attachment_type] | No | Specifies which types of attachments are included in the response. | |
| incident_id | Yes | The UUID of the incident. | |
| include | No | Specifies which types of related objects are included in the response. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | An array of incident attachments. | |
| included | No | Included related resources that the user requested. |