CustomDomain Docs
Cloud browser

Send the code a provider's frame asked for

Send the code a provider's frame asked for: CustomDomain™ API reference in the cloud browser group. Covers parameters, request body, responses and error codes.

POST
/browser-sessions/{sid}:code

While the view says handback: {reason: code, relay: true}, the agent waits for a one time code the provider asks for in a frame of its own after the sign in (Squarespace's "Verify to continue"). The popup's own code screen sends it here; the agent types it into the provider's frame and presses its verify button. The code is kept nowhere: it goes to the waiting run and is forgotten, and it is in no log, trace or model prompt.

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.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/browser-sessions/string:code" \  -H "Content-Type: application/json" \  -d '{    "code": "string"  }'
Empty
{  "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"}