Skip to main content
POST
Create Invitation

Authorizations

Authorization
string
header
required

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

Path Parameters

team_id
string<uuid>
required

Body

application/json

Schema for creating a new team invitation.

email
string<email>
required
role
enum<string>
default:operator

User roles within teams (hierarchical).

  • OWNER (4): Full control including team deletion
  • ADMIN (3): All operations except team deletion
  • OPERATOR (2): Day-to-day operations (run jobs, view logs), no setup/config
  • VIEWER (1): Read-only audit access
Available options:
viewer,
operator,
admin,
owner

Response

Successful Response

Response after creating an invitation.

id
string<uuid>
required
email
string
required
role
enum<string>
required

User roles within teams (hierarchical).

  • OWNER (4): Full control including team deletion
  • ADMIN (3): All operations except team deletion
  • OPERATOR (2): Day-to-day operations (run jobs, view logs), no setup/config
  • VIEWER (1): Read-only audit access
Available options:
viewer,
operator,
admin,
owner
status
enum<string>
required

Team invitation status values.

Available options:
pending,
accepted,
declined,
expired,
revoked
invited_by
string<uuid>
required
created_at
string<date-time>
required
expires_at
string<date-time>
required