Sign in

v1

latestOpenAPI 3.0.2Apache-2.02026-07-142963051.0 MB
Invites

Get user invite status

Returns the status of a user invite.

get/invites/{invite_id}

Path parameters

invite_idstring required

The ID of an invite.

Query parameters

fieldsstring[]

A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response.

Be aware that specifying this parameter will have the effect that none of the standard fields are returned in the response unless explicitly specified, instead only fields for the mini representation are returned, additional to the fields requested.

Response

Returns an invite object.

idstring required

The unique identifier for this invite.

type'invite' required

The value will always be invite.

statusstring

The status of the invite.

created_atstring date-time

When the invite was created.

modified_atstring date-time

When the invite was modified.

Example response

{
  "id": "11446498",
  "type": "invite",
  "invited_to": {
    "id": "11446498",
    "type": "enterprise",
    "name": "Acme Inc."
  },
  "actionable_by": {
    "id": "11446498",
    "type": "user",
    "name": "Aaron Levie",
    "login": "ceo@example.com"
  },
  "invited_by": {
    "id": "11446498",
    "type": "user",
    "name": "Aaron Levie",
    "login": "ceo@example.com"
  },
  "status": "pending",
  "created_at": "2012-12-12T10:53:43-08:00",
  "modified_at": "2012-12-12T10:53:43-08:00"
}