SnozeDevelopers
API referenceAdmin

Invite a platform admin

Creates or re-enables a platform admin account for an email address and returns it. Platform admins only, and owner-only while the `require-owner-for-admin-invites` policy is on; a request without an email address is rejected as a validation error. Idempotent by email: inviting an address that is already an active admin returns the existing record.

POST
/v1/admin/admins

Authorization

apiKey
headerAuthorizationBearer <snoze_sk_…>

Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.

Request Body

application/json
  1. body
email*string
role?|null

Response Body

Success

application/json
  1. response
data*
Example Request
curl -X POST 'https://api.snoze.dev/v1/admin/admins' \  -H 'Content-Type: application/json' \  -d '{  "email": "string"}'
Example Response
{  "data": {    "id": "string",    "email": "string",    "displayName": "string",    "role": "owner",    "status": "active",    "createdAt": "string",    "activatedAt": "string"  }}