Skip to main content
POST
Retrieve principals by reference

Path Parameters

org
string
required

ID of an organization The ID of an organization

Required string length: 3 - 64
Pattern: ^([a-z][a-z0-9-]{1,62}[a-z0-9])$
Example:

"my-org"

Body

application/json

A request to retrieve principals by reference.

For now, only service accounts can have an external ID.

items
object[]
required
Required array length: 1 - 100 elements

Either a principal ID, or a principal external ID

ignoreUnknownIds
boolean
default:false

If true, IDs that do not match existing principals will be ignored.

If false, the request will fail if any of the IDs do not match existing principals. This is the default behavior.

Response

200 - application/json

A list of principals.

items
object[]
required

A principal

Last modified on July 16, 2026