Content

Content is the source material your knowledge base is built from: documents, videos, and guides. These endpoints list those resources and return their text.

List content

GET /v1/content

Lists viewable content resources, most recent first, scoped to what you can see. Notes are never returned.

Query parameters

Parameter	Type	Notes
`query`	string	Title keywords. Every word must appear in the title, any order, case-insensitive.
`type`	string	One of `document`, `video`, `guide`.
`cursor`	string	Pagination cursor from a previous response.
`limit`	number	1–100. Default 50.

Request

curl "https://api.mereon.ai/v1/content?type=video&limit=20" \
  -H "Authorization: Bearer $MEREON_TOKEN"

Response

{
  "data": [
    {
      "id": "cnt_44de...",
      "title": "Finance Handbook",
      "type": "document",
      "summary": "Company finance policies and procedures.",
      "durationSeconds": null,
      "url": "https://mereon.ai/content/finance-handbook",
      "createdAt": "2026-01-10T08:00:00.000Z",
      "updatedAt": "2026-05-01T12:00:00.000Z"
    }
  ],
  "nextCursor": null
}

Get content metadata

GET /v1/content/{id}

Title, type, summary, and duration of a single resource.

curl "https://api.mereon.ai/v1/content/cnt_44de" \
  -H "Authorization: Bearer $MEREON_TOKEN"

Field	Type	Notes
`id`	string	Content id.
`title`	string	Resource title.
`type`	string	`document`, `video`, or `guide`.
`summary`	string \| null	Short summary, when available.
`durationSeconds`	number \| null	Media duration in seconds (videos only).

Get content text

GET /v1/content/{id}/text

Full document text or the video transcript, split into ordered chapters.

Response

{
  "contentId": "cnt_44de...",
  "title": "Finance Handbook",
  "type": "document",
  "url": "https://mereon.ai/content/finance-handbook",
  "chapters": [
    {
      "id": "chp_1b7c...",
      "sequence": 1,
      "headline": "Submitting an expense report",
      "text": "Attach receipts and submit before month end..."
    }
  ]
}

Field	Type	Notes
`chapters[].id`	string	Chapter id (matches `chapter` search results).
`chapters[].sequence`	number	Order within the content.
`chapters[].headline`	string \| null	Section heading, when present.
`chapters[].text`	string	The chapter’s text or transcript segment.

Get what a resource produced

GET /v1/content/{id}/knowledge

The topics this document or video was turned into, and how many items on each came from it. Answers “what did we learn from this”.

Request

curl "https://api.mereon.ai/v1/content/cnt_88fa/knowledge" \
  -H "Authorization: Bearer $MEREON_TOKEN"

Response

{
  "contentId": "cnt_88fa...",
  "title": "Service Manual 2024",
  "topics": [
    {
      "id": "top_71cd...",
      "name": "Lift inspection",
      "slug": "lift-inspection",
      "itemCount": 12,
      "url": "https://mereon.ai/topics/lift-inspection"
    }
  ]
}

itemCount counts the items on that topic which came from this resource, not the topic’s total. A topic built from three manuals reports a share against each.

Current records only: archived and superseded ones are left out, so this is what the resource supports now rather than everything it ever produced.

Get where a resource is relied on

GET /v1/content/{id}/usage

What depends on this resource. Answers “what breaks if this changes”.

Request

curl "https://api.mereon.ai/v1/content/cnt_88fa/usage" \
  -H "Authorization: Bearer $MEREON_TOKEN"

Response

{
  "contentId": "cnt_88fa...",
  "lessons": {
    "count": 48,
    "preview": [
      {
        "id": "lsn_6e3f...",
        "title": "Lift safety basics",
        "url": "https://mereon.ai/lessons/lsn_6e3f"
      }
    ]
  },
  "soleEvidenceTopics": {
    "count": 2,
    "preview": [
      {
        "id": "top_71cd...",
        "title": "Lift inspection",
        "url": "https://mereon.ai/topics/lift-inspection"
      }
    ]
  }
}

Field	Type	Notes
`lessons`	object	Lessons teaching what this resource supports, filtered to your lesson visibility.
`soleEvidenceTopics`	object	Topics this resource is the only evidence for. These are the ones that would lose their basis if it went away.
`*.count`	number	The true total.
`*.preview`	object[]	At most 20 entries, so the response cannot grow without limit. Report “used by 48 lessons” from `count`, list from `preview`.