Skip to content

Browser Session

Operations

Method Endpoint Description
POST /me/browser-session Create a single-use link that signs a browser in as the current user

Create a single-use link that signs a browser in as the current user

POST /me/browser-session

Returns a short-lived, single-use URL. Opening it exchanges the ticket for a session cookie. Intended for instances with no identity provider, where the browser has no other way to authenticate.

Operation ID: CreateBrowserSession

Responses

Status Description Content-Type Schema
200 OK application/json BrowserSessionResponse
400 BrowserSession request is invalid (Bad Request). application/json StandardErrorResponse
401 Unauthorized access. application/json StandardErrorResponse
403 Forbidden access. application/json StandardErrorResponse
404 BrowserSession not found. application/json StandardErrorResponse
409 BrowserSession data conflict. Data has changed since last read. application/json StandardErrorResponse
500 Something went wrong while processing BrowserSession. application/json StandardErrorResponse
default Unexpected error. application/json StandardErrorResponse

Schemas

BrowserSessionResponse

Properties

Property Type Required Description
ExpiresIn integer
Ticket string
URL string

StandardErrorResponse

The body of an error response: the error as data (Error), and as one string (message) for clients written before Error.

Properties

Property Type Required Description
Error The error: its message, category (Type), HTTP status, details, and structured items.
message string The error as one string: its message, with any details, items, and individual errors appended. Kept for clients written before Error; new clients read Error.