Skip to navigation
API ReferenceNamespaces

List namespaces

List namespaces owned by the caller's organization.

Authentication

AuthorizationBearer

WorkOS API key (Authorization: Bearer sk_…). Scope comes from the key’s permissions: a key carrying passport:admin has admin scope (full catalog CRUD), any other key has member scope (reads + access requests). Organization-owned keys are admin by ownership and carry no associated user; keys minted for a user carry theirs, which is what access requests and createdBy are attributed to.

Query parameters

limitintegerOptional1-100Defaults to 50

Page size. Out-of-range and non-numeric values are clamped rather than rejected: above 100 becomes 100, below 1 or non-numeric becomes the default 50. The applied value is returned as pagination.limit.

cursorstringOptional

Opaque pagination cursor from a previous page’s pagination.nextCursor.

Response headers

RateLimit-Limitinteger
Requests allowed in the current window.
RateLimit-Remaininginteger
Requests remaining in the current window.
RateLimit-Resetinteger
Unix epoch seconds when the window resets.

Response

OK
datalist of objects
paginationobject

Errors

400
Bad Request Error
401
Unauthorized Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error