Skip to main content
POST
Sign Up
Registers a new user within the specified project. On success, returns an access token, refresh token, and the created user object. The endpoint also accepts optional profile data and image file uploads for the avatar and banner.
This endpoint accepts multipart/form-data when uploading avatar or banner images. Send application/json for text-only registration.

Body Parameters

string
required
User’s email address. Must be a valid email format. Automatically lowercased.
string
required
User’s password.
string
Display name.
string
Unique username within the project. Automatically lowercased. Fails with 409 if already taken.
string
URL of the user’s avatar image. Ignored if avatarFile is also provided.
string
Short bio text.
object
Geographic location.
string
ISO 8601 datetime string representing the user’s date of birth.
object
Public custom key-value data attached to the user.
object
Private custom key-value data. Not returned to other users.
file
Avatar image file (multipart). Maximum 50 MB. Must be a valid image format. Requires avatarFile.options to also be present.
file
Banner image file (multipart). Maximum 50 MB. Must be a valid image format. Requires bannerFile.options to also be present.

Response

On success, returns HTTP 201 with:
boolean
true on successful registration.
string
Short-lived JWT access token. Expires in 30 minutes.
string
Long-lived JWT refresh token. Expires in 30 days.
object
The created user’s profile.

Error Responses

Also returned with "Banner image exceeds 50MB limit." for the banner file.
Returned when the uploaded file cannot be parsed as an image. Also returned for the banner file with "Banner file is not a valid image: ...".
Returned when avatarFile or bannerFile is uploaded without the corresponding .options field.

See Also