Register User

Prev Next
Post
/api/v1/users.register
  • An external member can use this endpoint to create an account on the workspace.
  • The number of requests you can make and the interval between each request depends on the workspace's rate limiter settings. You can find the settings from Administration > Settings > Rate Limiter > API Rate Limiter.

Changelog

Version Description
0.50.0 Added
Body parameters
object
username
string Required

The username for the user.

Examplerogersmith
email
string Required

The email for the user.

Exampleroger@example.com
pass
string Required

The password for the user.

Examplepassw0rd
name
string Required

The name of the user. The value can be an empty string if Require Name For Signup is disabled in account registration.

ExampleRoger Smith
secretURL
string

You may have been provided with a secret URL. It includes a string appended to the registration URL. For example, https://workspacedomain.com/register/my-secret-code. For this parameter, enter the additional string at the end of the URL.

ExampleJjwjg6gouWLXhMGKW
Responses
200

OK

Success Example
{
  "user": {
    "_id": "nSYqWzZ4GsKTX4dyK",
    "type": "user",
    "status": "offline",
    "active": true,
    "name": "Example User",
    "utcOffset": 0,
    "username": "example"
  },
  "success": true
}
Expand All
object
user
object
_id
string
type
string
status
string
active
boolean
name
string
utcOffset
integer
username
string
success
boolean
400

Bad Request

Example 1
{
  "success": false,
  "error": "must have required property 'pass' [invalid-params]",
  "errorType": "invalid-params"
}
object
success
boolean
error
string
errorType
string