Manage Case Links

Create, update, and delete links to external systems (ServiceNow, 4Me, etc.) or internal resources on a case.

Create Link

mutation createCaseLink($input: CreateCaseLinkInput!) {
    createCaseLink(input: $input) {
        id
        caseId
        url
        title
        type
        isInternal
        createdAt
    }
}

Variables

{
    "input": {
        "caseId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
        "url": "https://company.service-now.com/nav_to.do?uri=/incident.do?sys_id=123abc",
        "reference": "INC0123456",
        "title": "ServiceNow Incident",
        "type": "ServiceNow",
        "isInternal": false
    }
}

Update Link

Updates are partial (PATCH semantics) — only provided fields are modified.

mutation updateCaseLink($input: UpdateCaseLinkInput!) {
    updateCaseLink(input: $input) {
        id
        caseId
        url
        title
        type
        isInternal
        updatedAt
    }
}

Variables

{
    "input": {
        "id": "550e8400-e29b-41d4-a716-446655440400",
        "title": "ServiceNow Incident (Resolved)",
        "reference": "INC0123456"
    }
}

Delete Link

mutation deleteCaseLink($input: DeleteCaseLinkInput!) {
    deleteCaseLink(input: $input) {
        id
        caseId
        url
    }
}

Variables

{
    "input": {
        "id": "550e8400-e29b-41d4-a716-446655440400"
    }
}

Notes

• Links can reference external systems (ServiceNow, 4Me, etc.) or internal resources.
• reference is an optional identifier for the linked resource.
• isInternal links are only visible to internal users and defaults to false. Only partner/MDR provider users can set it to true.
• Retrieve a case's existing links via the links field on the case query. See Get a Case.
• deleteCaseLink is a hard delete. Data will not be recoverable.