CustomDomain™ docs
Cloud browser

Sign in with another account

Sign in with another account: CustomDomain™ API reference in the cloud browser group. Covers request parameters, the request body, responses and error codes.

POST
/browser-sessions/{sid}:switch-account

The customer signed in to the provider with an account that does not hold the domain (the view says wrongAccount), and tries another one. Allowed only then. The control plane signs the cloud browser out of the provider in the background (the provider's own sign out page, then the browser forgets the provider's cookies and storage, never a social sign in's) and opens the provider's sign in again; meanwhile the view says notice switching_account and takes no input. The sign in window starts again; the hard cap does not move. At most three accounts are tried: the third that does not hold the domain ends the session (failed, error.code browser_wrong_account), and so does a sign out that fails. No body.

Authorization

browserSession
AuthorizationBearer <token>

The session token of one cloud browser sign in, returned by POST /browser-sessions:redeem. It binds one session, one connection and one workspace, lives at most as long as the session, and stops working the moment the session ends. It lives in the popup's memory only.

In: header

Path Parameters

sid*string

The cloud browser session id, bs_ and 32 hex characters.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/browser-sessions/string:switch-account"
{  "state": "awaiting_sign_in"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}