The verified credential selects the organization. Workspace routes select a workspace; collection routes resolve its workspace and account on the server. All requests carry a bearer token; see authentication.

Errors are documented under error codes.

Pagination

The three list operations — collections.list, memory.list and workspaces.list — are cursor paginated. Both parameters are optional:

Each returns an envelope with data, has_more and next_cursor. Stop when has_more is false; next_cursor is null on the final page.

A cursor is signed: pass back the next_cursor you were given and never construct one. It is bound to the operation and path that issued it and expires fifteen minutes after issue; using it on a different path, or after it has expired, fails with invalid_request. Changing limit between pages is safe — a cursor marks a position in the listing, not a page number.