Invite user to organization

curl --request POST \
  --url https://app.azalt.co/api/v1/organizations/current/invitations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "jsmith@example.com",
  "assignedSiteIds": [
    "<string>"
  ],
  "role": "COLLECTOR"
}
'

{
  "success": true,
  "message": "<string>"
}

Organization

Invite user to organization

Send an invitation to a user to join the current organization with specified role and site access.

Invitation Process:

Generates secure invitation token with expiration
Sends email notification with invitation link
Creates pending membership record
Configures role and site assignments for acceptance

Role Assignment:

Owner: Full organizational control (limited to existing owners)
Manager: Site and user management within assigned sites
Collector: Data entry and form submission capabilities
Viewer: Read-only access to assigned sites and data

Site Assignment:

Specify which sites the user will have access to
Supports hierarchical access (parent sites include children)
Can be modified after the user accepts the invitation

Security Features:

Time-limited invitation tokens
Email verification required
Prevents duplicate invitations
Audit trail for compliance

Requires site manager permissions or higher to send invitations.

POST

organizations

current

invitations

Invite user to organization

curl --request POST \
  --url https://app.azalt.co/api/v1/organizations/current/invitations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "jsmith@example.com",
  "assignedSiteIds": [
    "<string>"
  ],
  "role": "COLLECTOR"
}
'

{
  "success": true,
  "message": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

string<email>

required

assignedSiteIds

string[]

required

Minimum array length: 1

role

enum<string>

default:COLLECTOR

Available options:

COLLECTOR,

APPROVER,

VIEWER,

MANAGER,

OWNER

Response

Successful response

success

boolean

required

message

string

required

List organization users Resend user invitation