Invitations

Create, accept, and manage organization invitations.

GET

Get an invitation by ID

/organizations/{organizationId}/invitations/{invitationId}

Retrieves a single invitation by its ID within an organization. Returns the invitation object including invitee email, assigned role, status (pending, accepted, expired), creator, and timestamps. The 'invitationId' param is the invitation UUID. Returns 404 if the invitation does not exist.

Parameters

organizationIdRequired

path · string

invitationIdRequired

path · string

SDK

1import os2from giantcontext import GiantContext3
4gc = GiantContext(api_key=os.environ["GIANTCONTEXT_API_KEY"])5
6orgs = gc.me.list_my_organizations()7org_id = orgs.items[0].id8
9invitation = gc.invitations.get_organization_invitation(10    organization_id=org_id,11    invitation_id="inv_123"12)13

GET

List invitations sent by an organization: pending, accepted and expired, with role

/organizations/{organizationId}/invitations

Returns a paginated list of pending, accepted, and expired invitations for an organization. Each invitation includes the invitee email, assigned role, status, creation date, and expiration. Supports search by email, filtering by status, and sorting. Requires owner or admin role within the organization.

Parameters

page

query · numberPage number to return, 1-indexed. Defaults to 1.

pageSize

query · numberItems per page (1-100). Defaults to 10.

lite

query · stringWhen 'true', return only essential fields (id, slug, title/name) to reduce payload size. Useful for context fetching and link resolution.

sort

query · stringSort specifier as 'field:direction'. Sortable fields: email, role, expiresAt, createdAt, acceptedAt. Direction is 'asc' or 'desc' and defaults to 'asc'.

query · stringFree-text search. Matched against: email, name.

role

query · stringFilter by role. Operators: role=value (equals), role_ne, role_gt, role_gte, role_lt, role_lte, role_like (contains), role_isnull=true|false, role_has=value (jsonb array contains), role[]=a&role[]=b (in).

query · stringFilter by email. Operators: email=value (equals), email_ne, email_gt, email_gte, email_lt, email_lte, email_like (contains), email_isnull=true|false, email_has=value (jsonb array contains), email[]=a&email[]=b (in).

organizationIdRequired

path · string

SDK

1import os2from giantcontext import GiantContext3
4gc = GiantContext(api_key=os.environ["GIANTCONTEXT_API_KEY"])5
6orgs = gc.me.list_my_organizations()7org_id = orgs.items[0].id8
9invitations = gc.invitations.list_organization_invitations(organization_id=org_id)10

BuiltAutonomously With AI

This content was built autonomously. Giant Context analyzed the site, determined what was missing, created and submitted an idea and draft, which Jesse accepted and published.