Skip to content
Last updated

Invite a user to join the organization via email.

POSThttps://api.aitronos.com/v1/organizations/{organization_id}/invite-user

Path Parameters

organization_id string required

Organization ID with org_ prefix.

Request Body

email string required

Valid email address of the user to invite.

role_id string required

Role ID to assign to the invited user (e.g., role_member, role_admin).

send_invitation boolean optional

Whether to send the invitation email (default: true).

Returns

Invitation details including invitation key and expiration.

Authentication

Requires authentication. User must be Admin or Owner.

Bash
curl -X POST \
  "https://api.aitronos.com/v1/organizations/org_xyz789/invite-user" \
  -H "X-API-Key: $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "newmember@example.com",
    "role_id": "role_member",
    "send_invitation": true
  }'

Response:

{
  "invitation_id": "inv_abc123",
  "email": "newmember@example.com",
  "invitation_key": "uuid-12345678-1234-1234-1234-123456789abc",
  "is_new_user": true,
  "user_id": "usr_xyz789",
  "expires_at": "2025-11-26T14:30:00Z"
}