Skip to main content
GET
List the tenant's model registry

Authorizations

Authorization
string
header
required

Obtain a token via the CLI auth flow (POST /v1/auth/sessions) or GitHub OAuth

Query Parameters

limit
integer
default:50

Rows per page. An out-of-range value is rejected, never clamped (UZ-LIBRARY-003). Clamping would hand back a short page that a caller could mistake for the whole set.

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

Opaque cursor from the previous page's next_cursor. Compose nothing here. A value this endpoint did not issue is rejected (UZ-LIBRARY-001). One issued for a different tenant or page size is rejected distinctly (UZ-LIBRARY-002). A cursor whose boundary row has since changed is not an error. It continues from that boundary, and may return an empty page.

Response

Model registry page

models
object[]
required

One page of entries, at most limit of them. Named models rather than the usual items because renaming a shipped v1 field is a breaking change. The pagination keys below were added beside it instead.

total
integer | null
required

Always null here. Keyset pagination does not count the full set, because that costs the scan the pagination exists to avoid. null is the documented "not computed" value. The key is always present, so clients need no branch for its absence.

next_cursor
string | null
required

Pass as starting_after to fetch the next page. null on the last page. Opaque — its encoding is not part of this API and may change.

platform_default_available
boolean
required

True when a shared default model is available.

platform_default
object

The active platform default's identity — present exactly when platform_default_available is true (both derive from the same read). Lets the Models page render the Default row's model, provider, and context without a second request.