Sign in

v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-10336.5 KB
sessions

Resume a session (re-issue hydrationId)

Issues a fresh hydrationId for an existing session. Call this server-side when the user returns after their previous token has expired. The new token must belong to the same org as the session.

post/{sessionId}/auth/

Path parameters

sessionIdstring uuid required
Example:1b6acf28-8748-4120-8d7a-4b7846d5e487

UUID of the session to resume. Returned as sessionId when the session was created. Returns 404 if the session doesn't exist or hasn't been saved within 7 days.

Request body

expires_ininteger

New token TTL in seconds. Defaults to 21600 (6 hours).

Example request

{
  "expires_in": 3600
}

Response

Fresh hydrationId issued

hydrationIdstring

The new access token. Pass this to the widget to resume the session.

expiresIninteger

Seconds until the new hydrationId expires.

Example response

{
  "hydrationId": "<new-signed-token>",
  "expiresIn": 21600
}