POST /auth/upgrade — Upgrade a guest to full account

Call POST /auth/upgrade to convert a guest session into a full registered account. You must be authenticated with the guest account’s JWT. All data created during the guest session — clothing items, outfits, and other records — is preserved under the same user ID after the upgrade. The same access token and refresh token remain valid after the call.

Endpoint

Field	Value
Method	`POST`
Path	`/auth/upgrade`
Auth required	Yes (guest Bearer token)
Rate limit	5 per minute

Request body

string

required

Email address for the new account. Must be unique across all registered accounts.

string

required

Username for the new account. Must be unique across all registered accounts.

string

required

Password for the new account.

string

Optional profile picture reference to associate with the account.

Response fields

Status: 201 Created

string

required

The unique identifier for the user. This is the same ID that was assigned during the guest session.

string

required

The username set during upgrade.

string

required

The email address set during upgrade.

boolean

required

Always false after a successful upgrade.

string

required

ISO 8601 timestamp of when the account was originally created (during the guest session).

string

required

ISO 8601 timestamp of when the account was last updated.

string

Profile picture reference, if one was provided in the request.

Example

cURL

curl --request POST \
  --url https://api.drssed.com/auth/upgrade \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
  --header 'Content-Type: application/json' \
  --data '{
    "email": "[email protected]",
    "username": "alex",
    "password": "s3cr3tpassword"
  }'

Response

{
  "user_id": "usr_a1b2c3d4e5f6",
  "username": "alex",
  "email": "[email protected]",
  "is_guest": false,
  "created_at": "2024-11-01T09:15:00Z",
  "updated_at": "2024-11-01T09:22:00Z"
}

Call this endpoint after a user completes onboarding in your app to preserve all the data they created as a guest. There is no need to re-authenticate — your existing tokens continue to work.

Auth

Wardrobe

Outfits

Images

Sync

Account

POST /auth/upgrade — Upgrade a guest to full account

Endpoint

Request body

Response fields

Example

​Endpoint

​Request body

​Response fields

​Example

Endpoint

Request body

Response fields

Example