Skip to main content
GET
Error

Authorizations

Authorization
string
header
required

The control surface credential. Send Authorization: Bearer <token>.

Two kinds of token are accepted and they are told apart by shape, not by a separate header. A token beginning pbk_ or puk_ is an org scoped API key, whose public half and secret half are generated together and of which only a hash of the secret is ever stored; anything else is treated as an OAuth 2.1 access token and verified against the authorization server's keys.

Both resolve to the same context: an org, a principal and a set of scopes. Nothing downstream branches on which channel you used, with one deliberate exception, key management, which requires a signed-in person so that a key can never mint another key.

Scopes are enforced when MCP tools are REGISTERED rather than when they are called, so a tool your credential cannot use is absent from tools/list rather than refused mid gesture.

Query Parameters

limit
integer

Maximum model identities, default 100; quote budget may shorten a page.

Required range: 1 <= x <= 100
cursor
string

Opaque nextCursor from the preceding page, with the same q.

Required string length: 1 - 1024
model
string

Read one canonical identity, including an off-page saved selection; mutually exclusive with q and cursor.

Pattern: ^[a-z0-9][a-z0-9-]{0,63}$
q
string

Trimmed case-insensitive substring search over all canonical model IDs, names and brands before paging.

Required string length: 1 - 80
identityId
string

Opaque requested app-facing identity from identities, or any for automatic allocation. This choice is separate from compute configuration, binds the original quote, and must remain the same when following cursor pages.

Required string length: 1 - 160

Response

Authoritative durable projection.

quotes
object[]
required
Maximum array length: 100
updatedAt
string<date-time>
required
models
object[]
Maximum array length: 100
identities
object[]
Maximum array length: 500
identityRevision
string
identitySelection
object | null
nextCursor
string | null
catalogRevision
string
Pattern: ^[a-f0-9]{64}$