Hand a connected cloud browser to a person
Gives control to the person in the live view before they take it themselves.
Requires scope: browser
Gives control to the person in the live view before they take it themselves. Your connection's input, navigation and tab changes then fail with CDP error -32001 until control is released. The person can also take and give back control from the live view.
Authorization
bearerAuth Authorization: Bearer <key>. Read the key from the SPICRAWL_API_KEY environment
variable; never hard-code or log it. spicrawl_test_… keys can never spend live
credits. Scopes: scrape, batch, sessions (granted by default), browser
and read (granted deliberately). A missing scope is 403 ERR::AUTH::INSUFFICIENT_SCOPE naming the scope.
In: header
Path Parameters
The session_id that POST /v1/browser/token returned for this connection. An unknown, closed or other organization's session answers 404 ERR::REQUEST::NOT_FOUND.
^bs[0-9a-f]{24}$Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/v1/browser/sessions/bs4f0c2a9e1d7b38c65a0e9f12/takeover"{ "session_id": "string", "status": "running", "controller": "agent", "expires_at": "2019-08-24T14:15:22Z"}Get a live view link for a connected cloud browser POST
A link a person opens to watch the cloud browser your CDP connection is driving and take control of it: the same tabs, cookies and page.
Give a connected cloud browser back to the agent POST
Gives control back to your CDP connection; its input and navigation reach the browser again.