Developers

API reference

The Mnemos REST API is the same surface our product is built on. Every action a user takes is available programmatically.

Base URL and content type

endpoint

Base URL:     https://api.mnemos.ai/v1
Content-Type: application/json; charset=utf-8
Accept:       application/json
Encoding:     gzip, br

Authentication

Every request must carry a bearer token. Tokens are issued at Settings → API keys and carry an explicit scope set. See the authentication guide for key types, scopes, and rotation.

example

curl https://api.mnemos.ai/v1/workspaces \
  -H "Authorization: Bearer $MNEMOS_API_KEY"

Pagination

List endpoints are cursor-paginated. Each response includes data, has_more, and next_cursor. Pass cursor=<value> and an optional limit (max 200, default 50) to fetch the next page.

response

{
  "data": [ /* ... */ ],
  "has_more": true,
  "next_cursor": "eyJpZCI6InNvcF8wMUgifQ=="
}

Errors

Errors follow RFC 7807 problem-details. See the full table in the errors reference.

error

{
  "type": "https://errors.mnemos.ai/permission_denied",
  "title": "Permission denied",
  "status": 403,
  "detail": "API key is missing the 'sops:write' scope.",
  "instance": "req_01HZX..."
}