sandbox_takeover

Asks a person to do what only they can (signing in, a CAPTCHA, a code) on the box's live screen, and waits for them to hand it back while the takeover link lasts: 30 minutes, or 30 minutes from when they first open it if that is later.

Blocks until a person hands the box back, or the takeover link expires. The link is valid for 30 minutes from the call; when the person first opens it, it is extended to 30 minutes from then, so a person who sees it late still has the full time, and the progress messages say until when it works. The link carries the account's language (&lang=), so the takeover page opens in it even in a browser set to another language, unless that browser has a language chosen in the app. The person sees your note in the app, works on the live screen, presses Hand back, and can leave a message; that message is the tool result. While they work, sandbox_exec waits (HTTP 423), but sandbox_shot of the screen, a window or a URL still answers, with takeover: true, so you can follow what they do. Use it only for what only they can do before you can go on: signing in, CAPTCHAs, a code sent to their phone, payment confirmations. To have them try what you built, a phone or desktop app included, use sandbox_review: it waits for their report or completion within the client's supported limit. If the client cuts the call off, the takeover stays open; sandbox_status shows it and calling sandbox_takeover again with the same id resumes waiting.

Every tool and topic is listed in the tool reference.