Incoming Publication References for Media

Returns Reference Objects pointing to this media entry from publications.

GET/api/2026-03/mediaLibrary/{mediaId}/incomingDocumentReferences

public-api:read

Latest version (since 2026-01)

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

Path Parameters

Parameter	Type	Description
`mediaId`*	`string`

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 published 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 returns all publications which link to this Media Library Entry (via content or metadata)

Use Cases

Useful to know if the Media Library Entry is in use when revoking or archiving

Responses

{
  "total": 5,
  "cursor": "eyJhIjpbIjE3NjUyNjIxODYuMjgyIiw2NCw2NF19",
  "results": [
    {
      "id": 2,
      "references": [
        {
          "id": "9fKagDCiN6sb",
          "type": "image",
          "location": "image-directive",
          "componentId": "doc-1ev8345oj0",
          "componentName": "image",
          "directiveName": "image"
        },
        {
          "id": "9fKagDCiN6sb",
          "type": "image",
          "location": "metadata",
          "propertyName": "teaserImage"
        }
      ]
    },
    {
      "id": 3,
      "references": [
        {
          "id": "9fKagDCiN6sb",
          "type": "image",
          "location": "image-directive",
          "componentId": "doc-1euq8lq1o0",
          "componentName": "image",
          "directiveName": "image"
        },
        {
          "id": "9fKagDCiN6sb",
          "type": "image",
          "location": "metadata",
          "propertyName": "teaserImage"
        }
      ]
    }
  ]
}