Incoming Draft References

Returns Reference Objects pointing to this draft from other documents.

GET/api/2026-03/drafts/{documentId}/incomingDocumentReferences

public-api:drafts:read

Latest version (since 2026-01)

ACCESS_TOKEN=ey1234
curl -k -X GET "https://server.livingdocs.io/api/2026-03/drafts/{documentId}/incomingDocumentReferences" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Path Parameters

Parameter	Type	Description
`documentId`*	`integer`

Query Parameters

Query String

Passed as URL query string. Comma-separated values for arrays (e.g. ?contentTypes=regular,author).

Parameter	Type	Description
`limit`	`integer`	A limit for how much documents to retrieve. Defaults to 100. Max. 100.
`offset`	`integer`	An offset into the query. Useful when getting more than 100 results (pagination).
`after`	`string`	The `cursor` provided in the response can be passed back for pagination instead of using `offset`.

Description

This endpoint is functionally equivalent to the Incoming Document References endpoint for publications. But with this draft endpoint you will receive references from unpublished documents as well as references from the current state of documents even if these latest updates to the document are not published yet.

Responses

{
  "total": 5,
  "cursor": "eyJhIjpbIjE3NjUyNjIxODYuMjgyIiw2NCw2NF19",
  "results": [
    {
      "id": 4,
      "references": [
        {
          "id": "1",
          "type": "document",
          "location": "include-directive",
          "componentId": "doc-1euiflvoq0",
          "serviceName": "editable-teaser",
          "propertyName": "article",
          "componentName": "teaser-include",
          "directiveName": "teaser"
        }
      ]
    },
    {
      "id": 2,
      "references": [
        {
          "id": "1",
          "type": "document",
          "location": "include-directive",
          "componentId": "doc-1eu6i7l880",
          "serviceName": "editable-teaser",
          "propertyName": "article",
          "componentName": "teaser-include",
          "directiveName": "teaser"
        }
      ]
    }
  ]
}