List role bindings
List role bindings for the authenticated user's account, filtered by resource type. Results are paginated; use limit and cursor for subsequent pages.
The resource_type query parameter is required and must be one of SPACE or PROJECT. All bindings in the account are visible to any authenticated account member. Use user_id to narrow to a specific user.
<Note>This endpoint is in beta, read more here.</Note>
Query parameters
Maximum items to return
Opaque pagination cursor returned from a previous response (pagination.next_cursor). Treat it as an unreadable token; do not attempt to parse or construct it.
A universally unique identifier (base64-encoded opaque string).
Filter role bindings by user. When provided, only bindings assigned to this user are returned. Must be a valid global user ID.
Resource type for the binding. Only SPACE and PROJECT are supported for single-binding CRUD. resource_id must encode the same resource type.
Filter role bindings by resource type.
- SPACE — Return only space-level bindings.
- PROJECT — Return only project-level bindings.
Response
Returns a list of role binding objects.
Example response
{
"role_bindings": [
{
"role_id": "RW50aXR5OjEyMzQ1",
"user_id": "RW50aXR5OjEyMzQ1",
"resource_id": "RW50aXR5OjEyMzQ1"
}
]
}