API reference overview

The Mereon public API is a small, versioned 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. It is read-only unless a connection has been granted a write scope, which is how uploads and announcements are done.

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.
GET	/people	Find members by name or email.
GET	/teams	Teams and their members.
GET	/people/{id}/progress	A person’s enrollments and obligations, for the person and org admins.
GET	/people/{id}/learning-queue	A person’s learning queue, for the person, org admins and their managers.
GET	/org-chart	Every role, who holds it, and who it reports to.
GET	/me/reporting-line	Your roles, your manager and your direct reports.
GET	/me/obligations	Your assigned training and what is overdue.
GET	/me/enrollments	Your lesson enrollments and scores.
GET	/me/pop-quizzes	The pop quizzes sent to you.
GET	/me/learning-queue	What you should study next.
GET	/enrollments/{id}/quiz-results	Per-question quiz results.
GET	/pop-quizzes	The organization’s pop quizzes, for admins.
GET	/pop-quizzes/{id}	A pop quiz and how its recipients did.
GET POST PATCH DELETE	/announcements	Read, draft, send and withdraw announcements.

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

People and teamsFind a person, list teams

Company rolesRoles, the org chart, your reporting line

TrainingYour own training, a person's progress, quiz results

AnnouncementsRead, draft, send and withdraw