Skip to main content
POST
Invite people to a workspace

Authorizations

Authorization
string
header
required

Locus Pro dashboard session (Cognito). High-risk workspace administration requires an owner or admin role and fresh MFA/passkey step-up.

Headers

X-Locus-Step-Up
string<password>

Short-lived raw MFA/passkey step-up token bound to the authenticated Cognito subject. Send it alongside the dashboard Bearer token for workspace-administrator mutations when the base session does not itself prove MFA within the last ten minutes. Never send it with a tenant secret key.

Body

application/json
emails
string<email>[]
required
Required array length: 1 - 20 elements
Maximum string length: 254
role
enum<string>
required
Available options:
admin,
developer,
billing,
viewer

Response

Invitation records persisted and immediate delivery attempted