Base URL

https://platform.continualmi.com/v1

Every path on this page is relative to that base.

Authentication

All endpoints require a bearer token created on the Keys page. Keys have the shape cmi_live_<public>.<secret>; only a hash of the secret is stored.

Authorization: Bearer cmi_live_<public>.<secret>

Headers

Entities

A persistent being with server-side memory. Create it once, then send only new messages. Required scope for every entity endpoint: mgpt.responses:create. An entity is visible only to the account that created it; any key on that account can use it.

Create entity

Returns 201 with the entity object plus entity_id.

curl https://platform.continualmi.com/v1/entities \
  -H "Authorization: Bearer $CONTINUAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "model": "mgpt-1-27b", "name": "Ada", "instructions": "You are Ada." }'

List entities

The account's entities, most recently active first, up to 200. Returns { "object": "list", "data": [entity, …] }.

Retrieve entity

The entity object, including the live window's token and block counts. Returns 404 for an id that does not belong to the account.

Send message

Appends the message to the entity, rotates the window if it is over budget, generates the reply from the entity's window, and appends the reply. Writes to one entity are serialized: a second message while one is in flight returns 409.

Streamed (default): text/event-stream of chat.completion.chunk objects in the standard streaming shape — a usage chunk precedes [DONE]. The response also carries an X-Entity-Id header.

Buffered (stream: false): a chat.completion object with an extra entity_id field.

curl -N https://platform.continualmi.com/v1/entities/$ENTITY/messages \
  -H "Authorization: Bearer $CONTINUAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: msg-0412" \
  -d '{ "content": "Where did we leave off?" }'

data: {"id":"…","object":"chat.completion.chunk","model":"mgpt-1-27b","choices":[{"index":0,"delta":{"role":"assistant","content":"We were"},"finish_reason":null}]}
data: {"id":"…","object":"chat.completion.chunk","model":"mgpt-1-27b","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}
data: {"id":"…","object":"chat.completion.chunk","model":"mgpt-1-27b","choices":[],"usage":{"prompt_tokens":812,"completion_tokens":61,"total_tokens":873}}
data: [DONE]

usage.prompt_tokens reports what the model was shown, for transparency. You are billed for the message you sent and the reply, not for the window.

List messages

The transcript — every message ever, whether or not it is still in the window.

{
  "object": "list",
  "entity_id": "…",
  "data": [
    { "seq": 1, "role": "user",      "content": "…", "tokens": 18, "created_at": "2026-09-01T21:44:01Z" },
    { "seq": 2, "role": "assistant", "content": "…", "tokens": 41, "created_at": "2026-09-01T21:44:03Z" }
  ],
  "has_more": false,
  "next_after": 2
}

Retrieve window

What the model is shown on the next turn, verbatim: the ordered alive blocks. A summary block's covers is the inclusive transcript range it replaced; a message block covers exactly its own seq.

{
  "entity_id": "…",
  "object": "entity.window",
  "budget_tokens": 32000,
  "tokens": 1418,
  "blocks": [
    { "id": "…", "kind": "summary", "role": "system",    "content": "…", "tokens": 210, "covers": [1, 38] },
    { "id": "…", "kind": "message", "role": "user",      "content": "…", "tokens": 12,  "covers": [39, 39] },
    { "id": "…", "kind": "message", "role": "assistant", "content": "…", "tokens": 61,  "covers": [40, 40] }
  ]
}

Export entity

Content-negotiated. With Accept: application/json (default) the response is the manifest plus the full transcript. With Accept: application/x-continual-entity it is a tar archive containing manifest.json, transcript.json and window.json. Model state joins the archive when native weights serve; the container does not change.

curl https://platform.continualmi.com/v1/entities/$ENTITY/export \
  -H "Authorization: Bearer $CONTINUAL_API_KEY" \
  -H "Accept: application/x-continual-entity" -o ada.tar

Delete entity

Hard-deletes transcript, window and state. Returns 202 { "id": "…", "object": "entity", "deleted": true }; removal completes within 24 hours across backups. Irreversible.

The entity object

{
  "id": "551e9290-…",
  "object": "entity",
  "name": "Ada",
  "instructions": "You are Ada.",
  "model": "mgpt-1-27b",
  "state": "none",
  "read_only": false,
  "transcript": { "messages": 40, "tokens": 6120, "cap_tokens": 1000000 },
  "window":     { "budget_tokens": 32000, "tokens": 1418, "blocks": 3 },
  "created_at": "2026-09-01T21:44:00Z",
  "updated_at": "2026-09-01T22:10:12Z"
}

Errors

Errors return JSON with an error field and an HTTP status.

{ "error": "Unsupported model: example-model" }

Scopes