Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.drssed.app/llms.txt

Use this file to discover all available pages before exploring further.

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

FieldValue
MethodPOST
Path/auth/guest
Auth requiredNo
Rate limit5 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.