Entities

Link multiple entities at once

POST https://{tenant}.atomicwork.com/api/v1/entities/{entity_type}/{display_id}/links

Creates multiple relationships between the source entity and target entities. Each link can be a different relationship type and direction.

Authorization

X-Api-Keyheaderstringrequired

API key authentication.

Headers

X-Workspace-Idheaderstring

Path Parameters

entity_typepathenum (string)required

The entity type (e.g. REQUEST, CHANGE)

Allowed valuesREQUESTSERVICE_REQUESTQUESTION_REQUESTINCIDENT_REQUESTINCIDENTPROBLEM_REQUESTPROBLEMUSERSERVICE_ITEMCUSTOM_FORMSURVEYASSETCHANGECHANGE_TEMPLATECUSTOM_OBJECTNO_OBJECTEXTERNAL_WEBHOOK

display_idpathstringrequired

The display ID of the source entity (e.g. REQ-123, CHG-456)

Body

reference_keybodystringrequired

Reference key of the relationship (e.g., "relates", "blocks", "causes", or "implicit_causes")

entitiesbodyarray of objectrequired

List of entity groups to link, each specifying a target entity type and its display IDs

properties

Response

200

Successful response

cURL

curl -X POST 'https://{tenant}.atomicwork.com/api/v1/entities/{entity_type}/{display_id}/links' \
  -H 'X-Api-Key: <api-key>' \
  -H 'Content-Type: application/json' \
  -d '{"reference_key": "string", "entities": [{"entity_type": "REQUEST", "display_ids": ["\u2026"]}]}'