List Invitations

GET

/api/v1/invitations

API de Produção

List invitations (Protected).

Args: tenant_id: Optional tenant filter status_filter: Optional status filter current_user: Current authenticated user db: Database session

Returns: List of invitations

Authorizations

HTTPBearer

Parameters

Query Parameters

tenant_id

Any of:

integer
null

integer

Filter by tenant ID

status_filter

Any of:

InvitationStatus
null

InvitationStatus

Invitation status

string

Allowed values: pending accepted expired cancelled

Filter by status

Responses

200

Successful Response

Response List Invitations Api V1 Invitations Get

Array<object>

InvitationResponse

Schema for invitation data in responses.

object

required

integer

tenant_id

required

Tenant Id

integer

email

required

Email

string

role

required

UserRole

User roles within a tenant.

string

Allowed values: owner admin agent viewer

status

required

InvitationStatus

Invitation status

string

Allowed values: pending accepted expired cancelled

token

required

Token

string

invited_by_user_id

required

Invited By User Id

integer

expires_at

required

Expires At

string format: date-time

accepted_at

Any of:

string
null

string format: date-time

cancelled_at

Any of:

string
null

string format: date-time

created_at

required

Created At

string format: date-time

updated_at

required

Updated At

string format: date-time

tenant_name

Any of:

string
null

string

invited_by_name

Any of:

string
null

string

Example

{
  "created_at": "2025-11-01T12:00:00Z",
  "email": "novocolaborador@empresa.com",
  "expires_at": "2025-11-08T12:00:00Z",
  "id": 1,
  "invited_by_user_id": 3,
  "role": "agent",
  "status": "pending",
  "tenant_id": 1,
  "token": "abc123def456",
  "updated_at": "2025-11-01T12:00:00Z"
}

422

Validation Error

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string