Update an incident timestamp override
WARNINGNote: This endpoint is in preview and is subject to change.
If you have any feedback, contact Datadog support.
PATCH
https://api.datadoghq.com/api/v2/incidents/{incident_id}/timestamp-overrides/{id}https://api.us3.datadoghq.com/api/v2/incidents/{incident_id}/timestamp-overrides/{id}https://api.us5.datadoghq.com/api/v2/incidents/{incident_id}/timestamp-overrides/{id}https://api.datadoghq.eu/api/v2/incidents/{incident_id}/timestamp-overrides/{id}https://api.ap1.datadoghq.com/api/v2/incidents/{incident_id}/timestamp-overrides/{id}https://api.ap2.datadoghq.com/api/v2/incidents/{incident_id}/timestamp-overrides/{id}https://api.uk1.datadoghq.com/api/v2/incidents/{incident_id}/timestamp-overrides/{id}https://api.ddog-gov.com/api/v2/incidents/{incident_id}/timestamp-overrides/{id}https://api.us2.ddog-gov.com/api/v2/incidents/{incident_id}/timestamp-overrides/{id}Présentation
Update a timestamp override for an incident.
OAuth apps require the incident_write authorization scope to access this endpoint.
Arguments
Paramètres du chemin
Name
Type
Description
incident_id [required]string
The UUID of the incident.
id [required]string
The UUID of the timestamp override.
Requête
Body Data (required)
Timestamp override patch payload.
Champ
Type
Description
data [required]object
Timestamp override data in a patch request.
attributesobject
Attributes for patching a timestamp override.
timestamp_value [required]date-time
The overridden timestamp value.
id [required]uuid
The timestamp override identifier.
type [required]enum
Incident timestamp override resource type.
Allowed enum values:
incidents_timestamp_overrides{
"data": {
"attributes": {
"timestamp_value": "2024-01-01T11:00:00.000Z"
},
"id": "00000000-0000-0000-0000-000000000001",
"type": "incidents_timestamp_overrides"
}
}Réponse
OK
Response with a single timestamp override.
Champ
Type
Description
data [required]object
Timestamp override data in a response.
attributes [required]object
Attributes of a timestamp override in a response.
created_at [required]date-time
Timestamp when the override was created.
deleted_atdate-time
Timestamp when the override was deleted.
incident_id [required]string
The incident identifier.
modified_at [required]date-time
Timestamp when the override was last modified.
timestamp_type [required]enum
The type of timestamp to override.
Allowed enum values:
detected, resolved, declaredtimestamp_value [required]date-time
The overridden timestamp value.
id [required]uuid
The timestamp override identifier.
relationshipsobject
Relationships for a timestamp override.
created_by_userobject
Relationship to user.
data [required]object
Relationship to user object.
id [required]string
A unique identifier that represents the user.
type [required]enum
Users resource type.
usersAllowed enum values:
userslast_modified_by_userobject
Relationship to user.
data [required]object
Relationship to user object.
id [required]string
A unique identifier that represents the user.
type [required]enum
Users resource type.
usersAllowed enum values:
userstype [required]enum
Incident timestamp override resource type.
Allowed enum values:
incidents_timestamp_overridesincluded[object]
Included related resources.
attributesobject
Attributes of user object returned by the API.
emailstring
Email of the user.
handlestring
Handle of the user.
iconstring
URL of the user's icon.
namestring
Name of the user.
uuidstring
UUID of the user.
idstring
ID of the user.
typeenum
Users resource type.
usersAllowed enum values:
users{
"data": {
"attributes": {
"created_at": "2024-01-01T00:00:00.000Z",
"deleted_at": null,
"incident_id": "00000000-0000-0000-0000-000000000000",
"modified_at": "2024-01-01T00:00:00.000Z",
"timestamp_type": "detected",
"timestamp_value": "2024-01-01T10:00:00.000Z"
},
"id": "00000000-0000-0000-0000-000000000000",
"relationships": {
"created_by_user": {
"data": {
"id": "00000000-0000-0000-2345-000000000000",
"type": "users"
}
},
"last_modified_by_user": {
"data": {
"id": "00000000-0000-0000-2345-000000000000",
"type": "users"
}
}
},
"type": "incidents_timestamp_overrides"
},
"included": [
{
"attributes": {
"email": "string",
"handle": "string",
"icon": "string",
"name": "string",
"uuid": "string"
},
"id": "string",
"type": "users"
}
]
}Bad Request
API error response.
Champ
Type
Description
errors [required][string]
A list of errors.
{
"errors": [
"Bad Request"
]
}Unauthorized
API error response.
Champ
Type
Description
errors [required][string]
A list of errors.
{
"errors": [
"Bad Request"
]
}Forbidden
API error response.
Champ
Type
Description
errors [required][string]
A list of errors.
{
"errors": [
"Bad Request"
]
}Not Found
API error response.
Champ
Type
Description
errors [required][string]
A list of errors.
{
"errors": [
"Bad Request"
]
}Too many requests
API error response.
Champ
Type
Description
errors [required][string]
A list of errors.
{
"errors": [
"Bad Request"
]
}Exemple de code
# Path parameters
export incident_id="CHANGE_ME"
export id="CHANGE_ME"
# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X PATCH "https://api.${DD_SITE}/api/v2/incidents/${incident_id}/timestamp-overrides/${id}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"timestamp_value": "2024-01-01T11:00:00.000Z"
},
"id": "00000000-0000-0000-0000-000000000001",
"type": "incidents_timestamp_overrides"
}
}
EOF# Path parameters
export incident_id="CHANGE_ME"
export id="CHANGE_ME"
# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X PATCH "https://api.${DD_SITE}/api/v2/incidents/${incident_id}/timestamp-overrides/${id}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"timestamp_value": "2024-01-01T11:00:00.000Z"
},
"id": "00000000-0000-0000-0000-000000000001",
"type": "incidents_timestamp_overrides"
}
}
EOF# Path parameters
export incident_id="CHANGE_ME"
export id="CHANGE_ME"
# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X PATCH "https://api.${DD_SITE}/api/v2/incidents/${incident_id}/timestamp-overrides/${id}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"timestamp_value": "2024-01-01T11:00:00.000Z"
},
"id": "00000000-0000-0000-0000-000000000001",
"type": "incidents_timestamp_overrides"
}
}
EOF# Path parameters
export incident_id="CHANGE_ME"
export id="CHANGE_ME"
# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X PATCH "https://api.${DD_SITE}/api/v2/incidents/${incident_id}/timestamp-overrides/${id}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"timestamp_value": "2024-01-01T11:00:00.000Z"
},
"id": "00000000-0000-0000-0000-000000000001",
"type": "incidents_timestamp_overrides"
}
}
EOF# Path parameters
export incident_id="CHANGE_ME"
export id="CHANGE_ME"
# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X PATCH "https://api.${DD_SITE}/api/v2/incidents/${incident_id}/timestamp-overrides/${id}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"timestamp_value": "2024-01-01T11:00:00.000Z"
},
"id": "00000000-0000-0000-0000-000000000001",
"type": "incidents_timestamp_overrides"
}
}
EOF# Path parameters
export incident_id="CHANGE_ME"
export id="CHANGE_ME"
# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X PATCH "https://api.${DD_SITE}/api/v2/incidents/${incident_id}/timestamp-overrides/${id}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"timestamp_value": "2024-01-01T11:00:00.000Z"
},
"id": "00000000-0000-0000-0000-000000000001",
"type": "incidents_timestamp_overrides"
}
}
EOF# Path parameters
export incident_id="CHANGE_ME"
export id="CHANGE_ME"
# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X PATCH "https://api.${DD_SITE}/api/v2/incidents/${incident_id}/timestamp-overrides/${id}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"timestamp_value": "2024-01-01T11:00:00.000Z"
},
"id": "00000000-0000-0000-0000-000000000001",
"type": "incidents_timestamp_overrides"
}
}
EOF# Path parameters
export incident_id="CHANGE_ME"
export id="CHANGE_ME"
# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X PATCH "https://api.${DD_SITE}/api/v2/incidents/${incident_id}/timestamp-overrides/${id}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"timestamp_value": "2024-01-01T11:00:00.000Z"
},
"id": "00000000-0000-0000-0000-000000000001",
"type": "incidents_timestamp_overrides"
}
}
EOF# Path parameters
export incident_id="CHANGE_ME"
export id="CHANGE_ME"
# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X PATCH "https://api.${DD_SITE}/api/v2/incidents/${incident_id}/timestamp-overrides/${id}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"timestamp_value": "2024-01-01T11:00:00.000Z"
},
"id": "00000000-0000-0000-0000-000000000001",
"type": "incidents_timestamp_overrides"
}
}
EOF