Get a namespace
Fetch one namespace. Link headers advertise resource-groups, secret-references, and endpoints collections.
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.
Path parameters
namespaceId
Response headers
RateLimit-Limit
Requests allowed in the current window.
RateLimit-Remaining
Requests remaining in the current window.
RateLimit-Reset
Unix epoch seconds when the window resets.
Link
RFC 8288 next-step relations (e.g. resource-groups, secret-bindings, cancel).
Response
OK
data
Errors
401
Unauthorized Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error