Retrieve

GET/invitations/{token}

View invitation details by token without consuming the token

Path ParametersExpand Collapse

token: string

minLength1

maxLength500

Header ParametersExpand Collapse

"X-Client-Request-ID": optional string

formatuuid

ReturnsExpand Collapse

created_by_name: string

Name of the user who sent the invitation

email: string

Email address for the invitation

formatemail

expires_at: string

When the invitation expires

formatdate-time

organization_name: string

Name of the organization being invited to

role: OrganizationRole

Role that will be assigned when invitation is accepted

Accepts one of the following:

"org_admin"

"org_member"

"org_viewer"

status: InvitationStatus

Status of an invitation

Accepts one of the following:

"pending"

"accepted"

"expired"

"revoked"

Retrieve

curl https://api.keycard.ai/invitations/$TOKEN

{
  "created_by_name": "created_by_name",
  "email": "dev@stainless.com",
  "expires_at": "2019-12-27T18:11:19.117Z",
  "organization_name": "organization_name",
  "role": "org_admin",
  "status": "pending"
}

Returns Examples

{
  "created_by_name": "created_by_name",
  "email": "dev@stainless.com",
  "expires_at": "2019-12-27T18:11:19.117Z",
  "organization_name": "organization_name",
  "role": "org_admin",
  "status": "pending"
}