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

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

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

• 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

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

Tip

Most clients and code generators can import the OpenAPI URL directly to scaffold a typed client.

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.

Introspection GET /me

Search GET and POST /search

Topics List, detail, and items

Items Item detail with evidence

Content List, metadata, and text

Lessons List and detail

Duties Ownership for an entity

Issues Data-quality issues