Skip to main content
GET
/
api
/
v1
/
access-control
/
principals
Search principals
curl --request GET \
  --url https://api.rigbox.dev/api/v1/access-control/principals \
  --header 'Authorization: Bearer <token>'
{
  "principals": [
    {
      "email": "<string>",
      "principal": "<string>",
      "user_id": "<string>",
      "display_name": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.rigbox.dev/llms.txt

Use this file to discover all available pages before exploring further.

Use this to look up principals by email or name before creating role bindings.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
resource
string
required

Canonical resource ref

​
query
string
required

Email or display-name search text

​
limit
integer

Optional result limit

Required range: x >= 0

Response

200 - application/json

Principals

​
principals
object[]
required