List Invitations

GEThttps://api.confident-ai.com/v2/organization/invitations

Lists the invitations to your organization that are still outstanding — those the invitee has not answered, and those they declined. An invitation disappears from this list once it is accepted, since the invitee is an organization member from then on, and once it is revoked. Invitations do not expire on their own, so a pending one stays acceptable until it is revoked or resent. Every entry carries the token from the invitee's invite link, so treat the response as sensitive.

GET/v2/organization/invitations

curl -X GET "https://api.confident-ai.com/v2/organization/invitations" \
  -H "CONFIDENT_API_KEY: <ORGANIZATION-API-KEY>"

200

{
  "success": true,
  "data": {
    "invitations": [
      {
        "id": 42,
        "email": "jane@acme.com",
        "status": "PENDING",
        "created_at": "2025-01-15T10:30:00.000Z",
        "organizationRoleId": "<ORGANIZATION-ROLE-ID>",
        "token": "<INVITATION-TOKEN>"
      }
    ]
  },
  "deprecated": false
}

Headers

CONFIDENT_API_KEYstringRequired
The organization API key for your Confident AI organization.

Response

List Invitations succeeded.

successboolean
Indicates if the request was successful.
dataobject
Every organization invitation that has not been accepted or revoked. Accepted invitations are left out, since the invitee is an organization member by then.
Show 1 propertyHide 1 property
- invitationslist of objects
  The organization's pending and declined invitations.
  Show 6 propertiesHide 6 properties
  - idinteger
    The id of the invitation, generated by Confident AI.
  - emailstring
    The email address the invitation was sent to, lowercased when it was created.
  - statusenum
    Where an invitation stands: PENDING while its link can still be accepted, ACCEPTED once the invitee joined, DECLINED once they turned it down. A declined invitation cannot be accepted again until it is resent.
    Show 3 enum valuesHide 3 enum values
    PENDING
    ACCEPTED
    DECLINED
  - created_atstring
    When the invitation was issued, as an ISO 8601 datetime. Resending an invitation stamps this again.
  - organizationRoleIdstring | null
    The id of the organization role the invitee lands on when they accept, or null to give them the default Member role.
  - tokenstring | null
    The token embedded in the invitee's invite link, returned unmasked. Anyone holding it can accept the invitation as the invited email address, so treat it as a secret. It is replaced whenever the invitation is resent, which invalidates any link sent earlier. It is null when the invitation has no token stored, in which case its link only points the invitee at signup.
deprecatedboolean
Indicates if this endpoint is deprecated.

Built byConfident AI