API referenceAuth
Create or reuse a Guest session
Creates a seven-day Guest session cookie when none is valid. Production may require turnstileToken. New creates are limited to 3 per client IP per 3600 seconds.
POST /api/v1/auth/guest-sessions
OpenAPI operation createGuestSession. This route does not use Clerk JWT or API key auth. Machine-readable contract: OpenAPI.
Request example
curl -X POST 'https://verbafy.io/api/v1/auth/guest-sessions'Responses
| Status | Description |
|---|---|
200 | Guest session created or reused |
400 | Validation or domain request error |
403 | Turnstile, ownership, or permission denied |
429 | Guest-session create rate limit for this client IP |
503 | Dependency unavailable |
Remote MCP at /api/v1/mcp is a companion wrap of this REST contract.
Claim Guest data onto a Registered User
Browser transition that moves Guest Transcripts and Chats onto the Clerk Registered User. Requires both a Clerk Bearer token and the Guest session cookie
Revoke the current Guest session
Clears the guest cookie and revokes the hashed token. DELETE /api/v1/auth/guest-sessions/current on the Verbafy REST API.