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/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 Returns all links associated with a case. Links define relationships (for example, BLOCKS) between cases. Requires entity_type and entity_id query parameters.
OAuth apps require the cases_read authorization scope to access this endpoint.
Arguments Query Strings The entity type to look up links for. Use CASE to find links for a specific case.
The UUID of the entity to look up links for.
Optional filter to only return links of a specific relationship type (for example, BLOCKS or CAUSES).
Response OK
Response containing a list of case links.
Expand All
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
# Required query arguments export entity_type = "CASE" export entity_id = "bf0cbac6-4c16-4cfb-b6bf-ca5e0ec37a4f" # 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.datadoghq.com "https://api.us3.datadoghq.com "https://api.us5.datadoghq.com /api/v2/cases/link ? entity_type = ${entity_type} & entity_id = ${entity_id} " \
-H "Accept: application/json" \
-H "DD-API-KEY: ${DD_API_KEY} " \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY} " 
