Users

Get a user

Reads one user with their project roster.

GET
/users/{id}

Reads one user with their project roster.

Authorization

x-api-key<token>

The per-tenant API key, copied from Settings → API & integrations. Sent as the x-api-key request header. The key is tenant-scoped and acts with Admin-equivalent, tenant-wide access.

In: header

Path Parameters

id*string

Resource id.

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/users/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "name": "string",  "email": "user@example.com",  "role": "admin",  "status": "active",  "projectIds": [    "b2d9859a-b2e9-4f49-b393-9a25d0eff2f8"  ]}
{  "error": {    "code": "unauthorized",    "message": "Missing or invalid API key."  }}
{  "error": {    "code": "not_found",    "message": "Not found."  }}

Create a user POST

Creates a tenant user (Admin or Site Crew) with an initial password and at least one project assignment, and returns the created user plus the credentials to share with them (there is no credentials email in v1). The email must be unique among active users in the tenant.

List users GET

Lists every user in the tenant (including revoked), paginated.