POST /auth/guest — Create a guest session instantly

Call POST /auth/guest to instantly create a temporary session without requiring any registration. The endpoint returns a JWT access token and a refresh token you can use right away to make authenticated requests. Guest sessions are suitable for onboarding flows where you want users to explore your app before committing to a full account.

Endpoint

Field	Value
Method	`POST`
Path	`/auth/guest`
Auth required	No
Rate limit	5 per hour

Request body

No request body is required.

Response fields

Status: 201 Created

access_token

string

required

JWT access token. Include this in the Authorization: Bearer <token> header on subsequent requests.

expires_in

integer

required

Number of seconds until the access token expires.

refresh_token

string

required

Token used to obtain a new access token when the current one expires. See POST /auth/refresh.

Example

cURL

curl --request POST \
  --url https://api.drssed.com/auth/guest

Response

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_in": 3600,
  "refresh_token": "drt_a1b2c3d4e5f6..."
}

Guest accounts can be upgraded to full registered accounts at any time using POST /auth/upgrade. Upgrading preserves all data created during the guest session.

POST /auth/login — Sign in with email or username/password

Auth

Wardrobe

Outfits

Images

Sync

Account

POST /auth/guest — Create a guest session instantly

Endpoint

Request body

Response fields

Example

​Endpoint

​Request body

​Response fields

​Example

Endpoint

Request body

Response fields

Example