Skip to navigation

List access requests

Members see only their own requests. Admins see the whole team (optional requesterId filter). Supports status and namespaceId query filters plus cursor pagination.

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 (1–100, default 50).

cursorstringOptional

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

zonestringOptional

Zone (id or name) to create in / list from, as returned by GET /public/v1/zones. Defaults to Production. An unknown zone returns 404, and a zone given more than once (or as zone[]) returns 400. An id always wins over a zone with the same name.

statusenumOptional
Allowed values:
namespaceIdstringOptionalformat: "uuid"
requesterIdstringOptional

Admin only — narrow to a requester. Ignored for member keys.

Response headers

RateLimit-LimitintegerOptional
Requests allowed in the current window.
RateLimit-RemainingintegerOptional
Requests remaining in the current window.
RateLimit-ResetintegerOptional
Unix epoch seconds when the window resets.

Response

OK
datalist of objects
paginationobject

Errors

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