Note : This endpoint is in preview and is subject to change.
If you have any feedback, contact Datadog support .
POST https://api.ap1.datadoghq.com/api/v2/cases/link https://api.ap2.datadoghq.com/api/v2/cases/link https://api.datadoghq.eu/api/v2/cases/link https://api.ddog-gov.com/api/v2/cases/link https://api.us2.ddog-gov.com/api/v2/cases/link https://api.datadoghq.com/api/v2/cases/link https://api.us3.datadoghq.com/api/v2/cases/link https://api.us5.datadoghq.com/api/v2/cases/link
Overview Creates a directional link between two cases (for example, case A blocks case B). The parent and child cases and their relationship type must be specified.
OAuth apps require the cases_write authorization scope to access this endpoint.
Request Body Data (required) Case link create request.
Expand All
Data object for creating a case link.
Attributes describing a directional relationship between two entities (cases, incidents, or pages).
child_entity_id [required ]
The UUID of the child (target) entity in the relationship.
child_entity_type [required ]
The type of the child entity. Allowed values: CASE, INCIDENT, PAGE, AGENT_CONVERSATION.
parent_entity_id [required ]
The UUID of the parent (source) entity in the relationship.
parent_entity_type [required ]
The type of the parent entity. Allowed values: CASE, INCIDENT, PAGE, AGENT_CONVERSATION.
The type of directional relationship. Allowed values: RELATES_TO (bidirectional association), CAUSES (parent causes child), BLOCKS (parent blocks child), DUPLICATES (parent duplicates child), PARENT_OF (hierarchical), SUCCESSOR_OF (sequence), ESCALATES_TO (priority escalation).
JSON:API resource type for case links.
Allowed enum values: link
{
"data" : {
"attributes" : {
"child_entity_id" : "4417921d-0866-4a38-822c-6f2a0f65f77d" ,
"child_entity_type" : "CASE" ,
"parent_entity_id" : "bf0cbac6-4c16-4cfb-b6bf-ca5e0ec37a4f" ,
"parent_entity_type" : "CASE" ,
"relationship" : "BLOCKS"
},
"type" : "link"
}
} Response Created
Response containing a single case link.
Expand All
A directional link representing a relationship between two entities. At least one entity must be a case.
Attributes describing a directional relationship between two entities (cases, incidents, or pages).
child_entity_id [required ]
The UUID of the child (target) entity in the relationship.
child_entity_type [required ]
The type of the child entity. Allowed values: CASE, INCIDENT, PAGE, AGENT_CONVERSATION.
parent_entity_id [required ]
The UUID of the parent (source) entity in the relationship.
parent_entity_type [required ]
The type of the parent entity. Allowed values: CASE, INCIDENT, PAGE, AGENT_CONVERSATION.
The type of directional relationship. Allowed values: RELATES_TO (bidirectional association), CAUSES (parent causes child), BLOCKS (parent blocks child), DUPLICATES (parent duplicates child), PARENT_OF (hierarchical), SUCCESSOR_OF (sequence), ESCALATES_TO (priority escalation).
The case link identifier.
JSON:API resource type for case links.
Allowed enum values: link
{
"data" : {
"attributes" : {
"child_entity_id" : "4417921d-0866-4a38-822c-6f2a0f65f77d" ,
"child_entity_type" : "CASE" ,
"parent_entity_id" : "bf0cbac6-4c16-4cfb-b6bf-ca5e0ec37a4f" ,
"parent_entity_type" : "CASE" ,
"relationship" : "BLOCKS"
},
"id" : "804cd682-55f6-4541-ab00-b608b282ea7d" ,
"type" : "link"
}
} 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 Copy
## default
#
# Curl command curl -X POST "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.datadoghq.com "https://api.us3.datadoghq.com "https://api.us5.datadoghq.com /api/v2/cases/link " \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY} " \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY} " \
-d @- << EOF
{
"data": {
"attributes": {
"child_entity_id": "4417921d-0866-4a38-822c-6f2a0f65f77d",
"child_entity_type": "CASE",
"parent_entity_id": "bf0cbac6-4c16-4cfb-b6bf-ca5e0ec37a4f",
"parent_entity_type": "CASE",
"relationship": "BLOCKS"
},
"type": "link"
}
}
EOF
