v7

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-013764062.2 MB

Public signup tokens

Create a public signup token

Lets administrators create a invite link to share with colleagues. People that join using the public invite are assigned the Viewer role

post/api/admin/invite-link/tokens

Request body

namestring required

The token's name.

expiresAtstring date-time required

The token's expiration date.

Response

The resource was successfully created.

secretstring required

The actual value of the token. This is the part that is used by Unleash to create an invite link

urlstring nullable required

The public signup link for the token. Users who follow this link will be taken to a signup page where they can create an Unleash user.

namestring required

The token's name. Only for displaying in the UI

enabledboolean required

Whether the token is active. This property will always be false for a token that has expired.

expiresAtstring date-time required

The time when the token will expire.

createdAtstring date-time required

When the token was created.

createdBystring nullable required

The creator's email or username

Example response

{
  "secret": "a3c84b25409ea8ca1782ef17f94a42fc",
  "url": "https://sandbox.getunleash.io/enterprise/new-user?invite=a3c84b25409ea8ca1782ef17f94a42fc",
  "name": "Invite public viewers",
  "enabled": true,
  "expiresAt": "2023-04-12T11:13:31.960Z",
  "createdAt": "2023-04-12T11:13:31.960Z",
  "createdBy": "someone@example.com",
  "users": [
    {
      "id": 123,
      "name": "User",
      "email": "user@example.com",
      "username": "hunter",
      "imageUrl": "https://example.com/242x200.png",
      "inviteLink": "http://localhost:4242/invite-link/some-secret",
      "loginAttempts": 3,
      "rootRole": 1,
      "seenAt": "2023-06-30T11:42:00.345Z",
      "createdAt": "2023-06-30T11:41:00.123Z",
      "accountType": "User",
      "scimId": "01HTMEXAMPLESCIMID7SWWGHN6",
      "seatType": "Regular",
      "companyRole": "Developer",
      "activeSessions": 2,
      "deletedSessions": 1
    }
  ],
  "role": {
    "id": 9,
    "type": "root",
    "name": "Editor",
    "description": "Users with the editor role have access to most features in Unleash but can not manage users and roles in the global scope. Editors will be added as project owners when creating projects and get superuser rights within the context of these projects. Users with the editor role will also get access to most permissions on the default project by default.",
    "project": "default"
  }
}