Add a user via a signup token
POST/invite/:token/signup
Create a user with the viewer root role and link them to the provided signup token
Request
Path Parameters
- application/json
Body
required
createInvitedUserSchema
The user's username. Must be unique if provided.
Hunter
The invited user's email address
hunter@example.com
The user's name
Hunter Burgan
The user's password
hunter2
Responses
- 200
- 400
- 409
userSchema
- application/json
- Schema
- Example (from schema)
Schema
The user id
123
Deprecated in v5. Used internally to know which operations the user should be allowed to perform
true
Name of the user
User
Email of the user
user@example.com
A unique username for the user
hunter
URL used for the user profile image
https://example.com/242x200.png
If the user is actively inviting other users, this is the link that can be shared with other users
http://localhost:4242/invite-link/some-secret
How many unsuccessful attempts at logging in has the user made
3
Is the welcome email sent to the user or not
false
The last time this user logged in
2023-06-30T11:42:00.345Z
The user was created at this time
2023-06-30T11:41:00.123Z
A user is either an actual User or a Service Account
User
Deprecated
The SCIM ID of the user, only present if managed by SCIM
01HTMEXAMPLESCIMID7SWWGHN6
{
"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,
"emailSent": false,
"rootRole": 1,
"seenAt": "2023-06-30T11:42:00.345Z",
"createdAt": "2023-06-30T11:41:00.123Z",
"accountType": "User",
"permissions": [
"string"
],
"scimId": "01HTMEXAMPLESCIMID7SWWGHN6"
}
The request data does not match what we expect.
- application/json
- Schema
- Example (from schema)
Schema
The ID of the error instance
9c40958a-daac-400e-98fb-3bb438567008
The name of the error kind
ValidationError
A description of what went wrong.
The request payload you provided doesn't conform to the schema. The .parameters property should be object. You sent [].
{
"id": "9c40958a-daac-400e-98fb-3bb438567008",
"name": "ValidationError",
"message": "The request payload you provided doesn't conform to the schema. The .parameters property should be object. You sent []."
}
The provided resource can not be created or updated because it would conflict with the current state of the resource or with an already existing resource, respectively.
- application/json
- Schema
- Example (from schema)
Schema
The ID of the error instance
9c40958a-daac-400e-98fb-3bb438567008
The name of the error kind
NameExistsError
A description of what went wrong.
There is already a feature called "my-awesome-feature".
{
"id": "9c40958a-daac-400e-98fb-3bb438567008",
"name": "NameExistsError",
"message": "There is already a feature called \"my-awesome-feature\"."
}