Skip to main content
POST
Read roles for a batch of email addresses

Authorizations

Authorization
string
header
required

Organization API key (sl_…).

Headers

x-tenant-id
string
required

The organization ID the request is scoped to.

Body

application/json

Read access assignments for the supplied email addresses.

ids
string[]
required

Email addresses to read. Addresses are case-insensitive and duplicates are returned once, in request order. An address need not belong to an existing member; default roles and all-users teams still apply.

Required array length: 1 - 1000 elements

Response

Successful Response

Role assignments for the requested addresses.

items
UserRoles · object[]
required
missing
string[]
required

Always empty: every address can hold roles, even before joining.