Skip to content

List your invitations

List your pending organization and team invitations with their roles and expiration dates. Use an invitation ID to accept or decline one.

Returns

#
dataobject[]Always present
Organization and team invitations awaiting your decision.
Show 1 attributeHide attributes
itemsobject
An organization or team invitation awaiting your decision.
Show 9 attributesHide attributes
expires_atstring (date-time)Always present
When the invitation expires.
idstringAlways present
Invitation ID.
invited_bystring
Inviter's email, when a person sent it. May be omitted.
invited_by_namestring
Inviter's display name, when available. May be omitted.
organizationstringAlways present
Organization the invitation joins.
rolestringAlways present
Offered organization role.
teamstring
Team being joined, as ORGANIZATION@TEAM. May be omitted.
team_rolestring
Offered team role, when applicable. May be omitted.
teamsstring[]
Additional teams included in the invitation. May be omitted.

Errors

#
CodeStatusWhat happened
invalid400An input is missing or invalid.
unauthenticated401The credential is missing, invalid, expired or revoked.
denied403The caller lacks permission for this action.
not_found404The resource is absent or inaccessible to this caller.
conflict409The request conflicts with the current resource state or an earlier request.
over_capacity409The request exceeds a resource or credential allowance.
access_list_full409The change would exceed the access-list allowance.
rate_limited429The caller's request rate exceeds its limit.
busy429Too much work is in progress to accept this request.
unknown503The outcome is unconfirmed; a change may have happened.
unavailable503The service or requested feature is unavailable.

Notes

#
  • API key permission: invitation view.