Sign in
team-invitations

Get Invitation

Get an invitation for the email deep-link landing page.

Args: invitation_id: Invitation identifier. auth: Authenticated caller. service: Team service.

Returns: Invitation details, scoped to the caller's email address.

Raises: HTTPException: If the identity email is unavailable.

get/invitations/{invitation_id}

Path parameters

invitation_idstring uuid required

Response

Successful Response

idstring required
team_idstring required
team_namestring required
emailstring required
role'owner' | 'billing' | 'admin' | 'editor' | 'viewer' required

Team member roles with hierarchical permissions.

Wire DTO mirror of the ORM TeamRoleType enum. Used only for API request/response serialization; authorization decisions route through the ORM matrix (database_tables.permissions), never this enum.

status'pending' | 'accepted' | 'declined' | 'expired' required

Status of a team invitation.

invited_bystring required
inviter_namestring nullable
inviter_emailstring nullable
created_atstring required
expires_atstring required
email_sentboolean

Whether the invitation email was successfully handed off to SendGrid. Only meaningful on the create-invite response; list endpoints do not track historical delivery and default to True.

Changes