Skip to content
MereonMereonMereon Docs

API reference overview

The Mereon public API is a small, versioned, read-only surface over your organization’s knowledge base. It returns JSON, authenticates with one header, and is scoped to exactly what the connected person can see.

Base URL

Section titled “Base URL”

All endpoints live under a single base URL:

https://api.mereon.ai/v1

Every path below is relative to the base URL. Authenticate by sending your personal access token on each request:

Authorization: Bearer mrn_...

Versioning

Section titled “Versioning”

The API is versioned in the path (/v1). Within a version, changes are additive only: new endpoints and new fields may appear, but existing fields will not be removed or renamed. A breaking change would ship under a new version such as /v2. Write your integrations to ignore fields they do not recognize.

Response conventions

Section titled “Response conventions”
  • Dates are ISO 8601 strings, for example 2026-06-17T14:30:00.000Z.
  • Deep links: every entity carries a url field linking to it in the Mereon app, so you can cite sources.
  • List envelope: list endpoints return { "data": [...], "nextCursor": ... }. See Pagination.
  • Single objects are returned directly (not wrapped), except search, duties, and me, which return a { "data": [...] } object or a plain object as noted on each page.

OpenAPI spec

Section titled “OpenAPI spec”

A machine-readable OpenAPI description is available, generated from the public API only:

  • Spec: GET https://api.mereon.ai/v1/openapi.json
  • Interactive (Swagger UI): https://api.mereon.ai/v1/docs

Endpoints at a glance

Section titled “Endpoints at a glance”
Method Path Purpose
GET /me Who this token belongs to.
GET POST /search Hybrid search over topics and content.
GET /topics List topics.
GET /topics/{id} Topic detail.
GET /topics/{id}/items Items under a topic.
GET /items/{id} Item detail with evidence.
GET /content List content resources.
GET /content/{id} Content metadata.
GET /content/{id}/text Document text or transcript.
GET /lessons List lessons.
GET /lessons/{id} Lesson detail.
GET /duties Who owns an entity.
GET /issues Data-quality issues.
IntrospectionGET /me
SearchGET and POST /search
TopicsList, detail, and items
ItemsItem detail with evidence
ContentList, metadata, and text
LessonsList and detail
DutiesOwnership for an entity
IssuesData-quality issues