Public signup tokens

Add a user via a signup token

Changed on

Create a user with the viewer root role and link them to the provided signup token

post/invite/{token}/signup

Request

  • Base URL
    https://app.unleash-instance.example.com
  • URL
    https://app.unleash-instance.example.com/invite/{token}/signup
  • Auth
    • API key in header Authorization
    • or HTTP bearer

Path parameters

tokenstring required

Request body

usernamestring

The user's username. Must be unique if provided.

emailstring required

The invited user's email address

namestring required

The user's name

passwordstring required

The user's password

Example request

{
  "username": "Hunter",
  "email": "hunter@example.com",
  "name": "Hunter Burgan",
  "password": "hunter2"
}

Response

userSchema

idinteger required

The user id

namestring nullable

Name of the user

emailstring

Email of the user

usernamestring nullable

A unique username for the user

imageUrlstring

URL used for the user profile image

inviteLinkstring

If the user is actively inviting other users, this is the link that can be shared with other users

loginAttemptsinteger

How many unsuccessful attempts at logging in has the user made

emailSentboolean

Is the welcome email sent to the user or not

rootRoleinteger

Which root role this user is assigned

seenAtstring date-time nullable

The last time this user logged in

createdAtstring date-time

The user was created at this time

accountType'User' | 'Service Account'

A user is either an actual User or a Service Account

permissionsstring[]

Deprecated

scimIdstring nullable

The SCIM ID of the user, only present if managed by SCIM

seatTypestring nullable

The seat type of this user

companyRolestring nullable

The role of the user within the company.

productUpdatesEmailConsentboolean nullable

Whether the user has consented to receive product update emails.

activeSessionsinteger nullable

Count of active browser sessions for this user

deletedSessionsnumber

Experimental. The number of deleted browser sessions after last login

Example response

{
  "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
}

Changes

  • 774670258f04Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 33b1dd229685Revision changes
    • info

      added the optional property to the response with the status