Look before you touch: an action is refused until this run has fetched at least one frame, because coordinates with no frame behind them have no meaning.
The action is bound to the frame it was decided on. Matching geometry is not enough on its own, since two different screens at the same resolution compare equal, so a superseded frame is refused and you are told to observe again. Retrying a request whose response you lost replays the recorded outcome instead of touching the screen twice.
A person may drive the same device beside this run, and their gestures go ahead of the run’s waiting ones. Every response carries others, what principals other than this run did since the frame this action was bound to, and by default an action is refused STALE_FRAME when that count is above zero: re-observe as you already do. Send refuseIfOthersActed: false to be informed instead of stopped. Gestures on one device run one at a time in arrival order, and a device with too many waiting answers ACTION_UNAVAILABLE; wait and retry, the run is untouched.
This operation reads no Authorization header. The run token in the path IS the credential, so the whole url is secret: never log it, paste it, or commit it. Every example writes {runToken} for that reason.
POST
/
vrx
/
{runToken}
/
v1
/
devices
/
{deviceId}
/
actions
Error
A valid request URL is required to generate request examples
The run token. Write {runToken}; never write a real one down.
deviceId
string
required
Must be the device this run is bound to. Anything else is refused as not found.
Body
application/json
One action.
tap
swipe
type_text
press_button
open_app
One action, discriminated by action. Coordinates are SCREENSHOT PIXELS of the frame you last fetched, and screen must echo that frame's size: a mismatch means every coordinate aims at the wrong thing, so it is refused rather than scaled.
Every variant also takes refuseIfOthersActed, this service's one addition to the dialect: the action is refused STALE_FRAME if another principal (a person driving the same device beside this run, for instance) acted after the frame it is bound to. On by default for a run, which always binds a frame; send false to be told through others instead. A worker that already re-observes on STALE_FRAME needs no new code.
action
string
required
Allowed value: "tap"
coordinate_space
string
required
Allowed value: "screenshot_pixels"
screen
object
required
Show child attributes
x
integer
required
y
integer
required
refuseIfOthersActed
boolean
Refuse this gesture (409 stale_frame, reason others_acted) if another principal acted on the device after observedFrame was taken. Sending true needs observedFrame; without it the body is refused as invalid_argument. Left out, it defaults by who is acting: on for an API key, a copilot or a run that sends observedFrame, off for a person acting directly, and off whenever no observedFrame is sent. You are told through others either way.
Response
The action was applied.
The action was applied. others says what principals other than this run did on the device since the frame the action was bound to; the driver ignores this body, and a worker that reads it looks again before its next decision when actions is above zero.
ok
boolean
required
others
object
required
What everybody else did on this device since you last looked. On a gesture the anchor is the frame you bound it to, else your previous gesture that reached the device (a refused one never anchors), else the last sixty seconds. A person may drive the same device beside an agent's run; each is informed of the other through this and neither is stopped.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"PhoneUse","description":"The mobile execution layer for AI agents.","colors":{"primary":"#0c6b4f","light":"#12a06a","dark":"#0a5a43"},"logo":{"light":"https://mintcdn.com/phonebase/asSC9ooLxq3ce7AH/images/logo-light.svg?fit=max\u0026auto=format\u0026n=asSC9ooLxq3ce7AH\u0026q=85\u0026s=797a832db8f0e271d5dbd6beba29a27b","dark":"https://mintcdn.com/phonebase/asSC9ooLxq3ce7AH/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=asSC9ooLxq3ce7AH\u0026q=85\u0026s=82325f8969ce89102cc6e3af558a4436","href":"https://phoneuse.com"},"favicon":"https://mintcdn.com/phonebase/asSC9ooLxq3ce7AH/images/favicon.svg?fit=max\u0026auto=format\u0026n=asSC9ooLxq3ce7AH\u0026q=85\u0026s=5aebe1e05fdad8394b3f4d54e6e75f22","appearance":{"default":"light"},"navbar":{"primary":{"type":"button","label":"Main site","href":"https://phoneuse.com"}},"footer":{"socials":{"website":"https://phoneuse.com"}},"contextual":{"options":["copy","view","claude","chatgpt","cursor","vscode","mcp"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"phonebase","hasAudioNarration":false,"actualSubdomain":"phonebase","customDomains":["docs.phoneuse.com"],"gitSource":{"type":"github","owner":"phoneuse-official","repo":"phoneuse-api","deployBranch":"docs-release","contentDirectory":"docs/site","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afd0a6c8745fb0d64fce35c","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API","count":158},{"language":"default","tag":"Endpoints","count":155},{"language":"default","tag":"Docs","count":34},{"language":"default","tag":"Managed Proxy","count":22},{"language":"default","tag":"Minute billing","count":22},{"language":"default","tag":"Devices","count":19},{"language":"default","tag":"Apps","count":18},{"language":"default","tag":"Provisioning","count":14},{"language":"default","tag":"API keys","count":12},{"language":"default","tag":"Copilot","count":10}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api/endpoints/device-surface/act-on-the-device","slug":"/api/endpoints/device-surface/act-on-the-device","pageMetadata":{"title":"Act on the device","description":"Look before you touch: an action is refused until this run has fetched at least one frame, because coordinates with no frame behind them have no meaning.\n\nThe action is bound to the frame it was decided on. Matching geometry is not enough on its own, since two different screens at the same resolution compare equal, so a superseded frame is refused and you are told to observe again. Retrying a request whose response you lost replays the recorded outcome instead of touching the screen twice.\n\nA person may drive the same device beside this run, and their gestures go ahead of the run's waiting ones. Every response carries `others`, what principals other than this run did since the frame this action was bound to, and by default an action is refused `STALE_FRAME` when that count is above zero: re-observe as you already do. Send `refuseIfOthersActed: false` to be informed instead of stopped. Gestures on one device run one at a time in arrival order, and a device with too many waiting answers `ACTION_UNAVAILABLE`; wait and retry, the run is untouched.\n\nThis operation reads no `Authorization` header. The run token in the path IS the credential, so the whole url is secret: never log it, paste it, or commit it. Every example writes `{runToken}` for that reason.","deprecated":null,"version":null,"openapi":"/api/openapi.json post /vrx/{runToken}/v1/devices/{deviceId}/actions","href":"/api/endpoints/device-surface/act-on-the-device","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Look before you touch: an action is refused until this run has fetched at least one frame, because coordinates with no frame behind them have no meaning.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"The action is bound to the frame it was decided on. Matching geometry is not enough on its own, since two different screens at the same resolution compare equal, so a superseded frame is refused and you are told to observe again. Retrying a request whose response you lost replays the recorded outcome instead of touching the screen twice.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"A person may drive the same device beside this run, and their gestures go ahead of the run’s waiting ones. Every response carries \", _jsx(_components.code, {\n children: \"others\"\n }), \", what principals other than this run did since the frame this action was bound to, and by default an action is refused \", _jsx(_components.code, {\n children: \"STALE_FRAME\"\n }), \" when that count is above zero: re-observe as you already do. Send \", _jsx(_components.code, {\n children: \"refuseIfOthersActed: false\"\n }), \" to be informed instead of stopped. Gestures on one device run one at a time in arrival order, and a device with too many waiting answers \", _jsx(_components.code, {\n children: \"ACTION_UNAVAILABLE\"\n }), \"; wait and retry, the run is untouched.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"This operation reads no \", _jsx(_components.code, {\n children: \"Authorization\"\n }), \" header. The run token in the path IS the credential, so the whole url is secret: never log it, paste it, or commit it. Every example writes \", _jsx(_components.code, {\n children: \"{runToken}\"\n }), \" for that reason.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Act on the device","description":"Look before you touch: an action is refused until this run has fetched at least one frame, because coordinates with no frame behind them have no meaning.\n\nThe action is bound to the frame it was decided on. Matching geometry is not enough on its own, since two different screens at the same resolution compare equal, so a superseded frame is refused and you are told to observe again. Retrying a request whose response you lost replays the recorded outcome instead of touching the screen twice.\n\nA person may drive the same device beside this run, and their gestures go ahead of the run's waiting ones. Every response carries `others`, what principals other than this run did since the frame this action was bound to, and by default an action is refused `STALE_FRAME` when that count is above zero: re-observe as you already do. Send `refuseIfOthersActed: false` to be informed instead of stopped. Gestures on one device run one at a time in arrival order, and a device with too many waiting answers `ACTION_UNAVAILABLE`; wait and retry, the run is untouched.\n\nThis operation reads no `Authorization` header. The run token in the path IS the credential, so the whole url is secret: never log it, paste it, or commit it. Every example writes `{runToken}` for that reason.","deprecated":null,"version":null,"openapi":"/api/openapi.json post /vrx/{runToken}/v1/devices/{deviceId}/actions","href":"/api/endpoints/device-surface/act-on-the-device","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"postVrxByRunTokenV1DevicesByDeviceIdActions","tags":["Device surface"],"summary":"Act on the device","description":"Look before you touch: an action is refused until this run has fetched at least one frame, because coordinates with no frame behind them have no meaning.\n\nThe action is bound to the frame it was decided on. Matching geometry is not enough on its own, since two different screens at the same resolution compare equal, so a superseded frame is refused and you are told to observe again. Retrying a request whose response you lost replays the recorded outcome instead of touching the screen twice.\n\nA person may drive the same device beside this run, and their gestures go ahead of the run's waiting ones. Every response carries `others`, what principals other than this run did since the frame this action was bound to, and by default an action is refused `STALE_FRAME` when that count is above zero: re-observe as you already do. Send `refuseIfOthersActed: false` to be informed instead of stopped. Gestures on one device run one at a time in arrival order, and a device with too many waiting answers `ACTION_UNAVAILABLE`; wait and retry, the run is untouched.\n\nThis operation reads no `Authorization` header. The run token in the path IS the credential, so the whole url is secret: never log it, paste it, or commit it. Every example writes `{runToken}` for that reason.","x-phoneuse-modes":["local","hosted"],"x-phoneuse-credential":"path-token","parameters":["4577efc5-c6c2-4472-a8dc-0140ca3e0c3d","469e3052-3d4e-4397-9f69-8b4db151268a"],"requestBody":"220dd445-ea44-44e2-a53d-e877a140a8d8","security":[],"responses":{"200":"d8e9c17a-3667-410e-ab2b-3813ef1d4b39","400":"a4a69178-f162-4795-a19e-2ae43c58c5bc","404":"a1044daa-ce59-4d33-bf9a-2897900a1753","409":"45e2bf64-33d5-4185-b5dd-c79751397388","413":"49a0d1b3-8cdd-4b52-a3a5-561d73b054a1","422":"7a0f048f-5570-4d86-8478-9e550c5ce0e5","429":"75842588-5591-41c4-82c0-95485a4e3aed","503":"db3b7a7a-868e-41dd-8382-91012c9ce3fd"},"method":"post","type":"path","servers":["0b8b9ab5-c46d-4bb8-88b0-6eeb0d5654ea"],"path":"/vrx/{runToken}/v1/devices/{deviceId}/actions","baseUrlOptions":["{origin}"],"title":"Act on the device","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"4577efc5-c6c2-4472-a8dc-0140ca3e0c3d":{"name":"runToken","in":"path","required":true,"description":"The run token. Write `{runToken}`; never write a real one down.","schema":{"type":"string","isRequired":true,"description":"The run token. Write `{runToken}`; never write a real one down.","uniqueKey":"","typeLabel":"string"}},"469e3052-3d4e-4397-9f69-8b4db151268a":{"name":"deviceId","in":"path","required":true,"description":"Must be the device this run is bound to. Anything else is refused as not found.","schema":{"type":"string","isRequired":true,"description":"Must be the device this run is bound to. Anything else is refused as not found.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"description":"One action.","required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","title":"tap","description":"One action, discriminated by `action`. Coordinates are SCREENSHOT PIXELS of the frame you last fetched, and `screen` must echo that frame's size: a mismatch means every coordinate aims at the wrong thing, so it is refused rather than scaled.\n\nEvery variant also takes `refuseIfOthersActed`, this service's one addition to the dialect: the action is refused `STALE_FRAME` if another principal (a person driving the same device beside this run, for instance) acted after the frame it is bound to. On by default for a run, which always binds a frame; send `false` to be told through `others` instead. A worker that already re-observes on `STALE_FRAME` needs no new code.","required":["action","coordinate_space","screen","x","y"],"properties":{"action":{"type":"string","const":"tap","isRequired":true,"uniqueKey":"oneOf.0.action","typeLabel":"string"},"coordinate_space":{"type":"string","const":"screenshot_pixels","isRequired":true,"uniqueKey":"oneOf.0.coordinate_space","typeLabel":"string"},"screen":{"type":"object","properties":{"width":{"type":"integer","isRequired":true,"uniqueKey":"oneOf.0.screen.width","typeLabel":"integer"},"height":{"type":"integer","isRequired":true,"uniqueKey":"oneOf.0.screen.height","typeLabel":"integer"}},"required":["width","height"],"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.0.screen","typeLabel":"object"},"x":{"type":"integer","isRequired":true,"uniqueKey":"oneOf.0.x","typeLabel":"integer"},"y":{"type":"integer","isRequired":true,"uniqueKey":"oneOf.0.y","typeLabel":"integer"},"refuseIfOthersActed":{"type":"boolean","description":"Refuse this gesture (409 `stale_frame`, reason `others_acted`) if another principal acted on the device after `observedFrame` was taken. Sending `true` needs `observedFrame`; without it the body is refused as `invalid_argument`. Left out, it defaults by who is acting: on for an API key, a copilot or a run that sends `observedFrame`, off for a person acting directly, and off whenever no `observedFrame` is sent. You are told through `others` either way.","uniqueKey":"oneOf.0.refuseIfOthersActed","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"tap · object"},{"type":"object","title":"swipe","description":"One action, discriminated by `action`. Coordinates are SCREENSHOT PIXELS of the frame you last fetched, and `screen` must echo that frame's size: a mismatch means every coordinate aims at the wrong thing, so it is refused rather than scaled.\n\nEvery variant also takes `refuseIfOthersActed`, this service's one addition to the dialect: the action is refused `STALE_FRAME` if another principal (a person driving the same device beside this run, for instance) acted after the frame it is bound to. On by default for a run, which always binds a frame; send `false` to be told through `others` instead. A worker that already re-observes on `STALE_FRAME` needs no new code.","required":["action","coordinate_space","screen","x1","y1","x2","y2"],"properties":{"action":{"type":"string","const":"swipe","isRequired":true,"uniqueKey":"oneOf.1.action","typeLabel":"string"},"coordinate_space":{"type":"string","const":"screenshot_pixels","isRequired":true,"uniqueKey":"oneOf.1.coordinate_space","typeLabel":"string"},"screen":{"type":"object","properties":{"width":{"type":"integer","isRequired":true,"uniqueKey":"oneOf.1.screen.width","typeLabel":"integer"},"height":{"type":"integer","isRequired":true,"uniqueKey":"oneOf.1.screen.height","typeLabel":"integer"}},"required":["width","height"],"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.screen","typeLabel":"object"},"x1":{"type":"integer","isRequired":true,"uniqueKey":"oneOf.1.x1","typeLabel":"integer"},"y1":{"type":"integer","isRequired":true,"uniqueKey":"oneOf.1.y1","typeLabel":"integer"},"x2":{"type":"integer","isRequired":true,"uniqueKey":"oneOf.1.x2","typeLabel":"integer"},"y2":{"type":"integer","isRequired":true,"uniqueKey":"oneOf.1.y2","typeLabel":"integer"},"duration_ms":{"type":"integer","minimum":1,"description":"Swipe duration in milliseconds, a positive integer. Defaults to 1000 when omitted; zero, a fraction or a string is refused rather than read as the default. Values above 10000 milliseconds are clamped to that ceiling rather than refused: a longer swipe runs at the ceiling instead of failing.","uniqueKey":"oneOf.1.duration_ms","typeLabel":"integer"},"refuseIfOthersActed":{"type":"boolean","description":"Refuse this gesture (409 `stale_frame`, reason `others_acted`) if another principal acted on the device after `observedFrame` was taken. Sending `true` needs `observedFrame`; without it the body is refused as `invalid_argument`. Left out, it defaults by who is acting: on for an API key, a copilot or a run that sends `observedFrame`, off for a person acting directly, and off whenever no `observedFrame` is sent. You are told through `others` either way.","uniqueKey":"oneOf.1.refuseIfOthersActed","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"oneOf.1","typeLabel":"swipe · object"},{"type":"object","title":"type_text","description":"One action, discriminated by `action`. Coordinates are SCREENSHOT PIXELS of the frame you last fetched, and `screen` must echo that frame's size: a mismatch means every coordinate aims at the wrong thing, so it is refused rather than scaled.\n\nEvery variant also takes `refuseIfOthersActed`, this service's one addition to the dialect: the action is refused `STALE_FRAME` if another principal (a person driving the same device beside this run, for instance) acted after the frame it is bound to. On by default for a run, which always binds a frame; send `false` to be told through `others` instead. A worker that already re-observes on `STALE_FRAME` needs no new code.","required":["action","text"],"properties":{"action":{"type":"string","const":"type_text","isRequired":true,"uniqueKey":"oneOf.2.action","typeLabel":"string"},"text":{"type":"string","maxLength":4096,"description":"At most 4096 characters, the same ceiling the MCP type_text tool publishes. Longer text is refused, not cut.","isRequired":true,"uniqueKey":"oneOf.2.text","typeLabel":"string"},"refuseIfOthersActed":{"type":"boolean","description":"Refuse this gesture (409 `stale_frame`, reason `others_acted`) if another principal acted on the device after `observedFrame` was taken. Sending `true` needs `observedFrame`; without it the body is refused as `invalid_argument`. Left out, it defaults by who is acting: on for an API key, a copilot or a run that sends `observedFrame`, off for a person acting directly, and off whenever no `observedFrame` is sent. You are told through `others` either way.","uniqueKey":"oneOf.2.refuseIfOthersActed","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"oneOf.2","typeLabel":"type_text · object"},{"type":"object","title":"press_button","description":"One action, discriminated by `action`. Coordinates are SCREENSHOT PIXELS of the frame you last fetched, and `screen` must echo that frame's size: a mismatch means every coordinate aims at the wrong thing, so it is refused rather than scaled.\n\nEvery variant also takes `refuseIfOthersActed`, this service's one addition to the dialect: the action is refused `STALE_FRAME` if another principal (a person driving the same device beside this run, for instance) acted after the frame it is bound to. On by default for a run, which always binds a frame; send `false` to be told through `others` instead. A worker that already re-observes on `STALE_FRAME` needs no new code.","required":["action","button"],"properties":{"action":{"type":"string","const":"press_button","isRequired":true,"uniqueKey":"oneOf.3.action","typeLabel":"string"},"button":{"type":"string","enum":["home","back","enter","delete","app_switch","power","volume_up","volume_down"],"description":"Matched case insensitively.","isRequired":true,"uniqueKey":"oneOf.3.button","typeLabel":"enum\u003cstring>"},"refuseIfOthersActed":{"type":"boolean","description":"Refuse this gesture (409 `stale_frame`, reason `others_acted`) if another principal acted on the device after `observedFrame` was taken. Sending `true` needs `observedFrame`; without it the body is refused as `invalid_argument`. Left out, it defaults by who is acting: on for an API key, a copilot or a run that sends `observedFrame`, off for a person acting directly, and off whenever no `observedFrame` is sent. You are told through `others` either way.","uniqueKey":"oneOf.3.refuseIfOthersActed","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"oneOf.3","typeLabel":"press_button · object"},{"type":"object","title":"open_app","description":"One action, discriminated by `action`. Coordinates are SCREENSHOT PIXELS of the frame you last fetched, and `screen` must echo that frame's size: a mismatch means every coordinate aims at the wrong thing, so it is refused rather than scaled.\n\nEvery variant also takes `refuseIfOthersActed`, this service's one addition to the dialect: the action is refused `STALE_FRAME` if another principal (a person driving the same device beside this run, for instance) acted after the frame it is bound to. On by default for a run, which always binds a frame; send `false` to be told through `others` instead. A worker that already re-observes on `STALE_FRAME` needs no new code.","required":["action","package"],"properties":{"action":{"type":"string","const":"open_app","isRequired":true,"uniqueKey":"oneOf.4.action","typeLabel":"string"},"package":{"type":"string","description":"The application id. Must be non empty.","isRequired":true,"uniqueKey":"oneOf.4.package","typeLabel":"string"},"refuseIfOthersActed":{"type":"boolean","description":"Refuse this gesture (409 `stale_frame`, reason `others_acted`) if another principal acted on the device after `observedFrame` was taken. Sending `true` needs `observedFrame`; without it the body is refused as `invalid_argument`. Left out, it defaults by who is acting: on for an API key, a copilot or a run that sends `observedFrame`, off for a person acting directly, and off whenever no `observedFrame` is sent. You are told through `others` either way.","uniqueKey":"oneOf.4.refuseIfOthersActed","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"oneOf.4","typeLabel":"open_app · object"}],"uniqueKey":"","typeLabel":"tap · object | swipe · object | type_text · object | press_button · object | open_app · object"},"examples":{"Example":{"title":"Example","value":{"action":"tap","coordinate_space":"screenshot_pixels","screen":{"width":123,"height":123},"x":123,"y":123,"refuseIfOthersActed":true}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"d8e9c17a-3667-410e-ab2b-3813ef1d4b39":{"description":"The action was applied.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","const":true,"isRequired":true,"uniqueKey":"ok","typeLabel":"boolean"},"others":{"type":"object","properties":{"actions":{"type":"integer","description":"How many actions principals other than you took on this device since your anchor. Pending and committed receipts count; failed ones do not.","isRequired":true,"uniqueKey":"others.actions","typeLabel":"integer"},"lastAt":{"oneOf":[{"type":"string","format":"date-time","description":"When the newest of them was requested, on this service's clock. Null when `actions` is 0.","isRequired":true,"uniqueKey":"others.lastAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the newest of them was requested, on this service's clock. Null when `actions` is 0.","isRequired":true,"uniqueKey":"others.lastAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"others.lastAt","typeLabel":"string\u003cdate-time> | null"},"by":{"type":"array","items":{"type":"string","enum":["person","agent"],"description":"Who they were.","uniqueKey":"others.by.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"`person` is a signed-in person acting directly; `agent` is an API key, a copilot, or a run. Each appears at most once, person first.","isRequired":true,"uniqueKey":"others.by","typeLabel":"enum\u003cstring>[]"}},"required":["actions","lastAt","by"],"additionalProperties":false,"description":"What everybody else did on this device since you last looked. On a gesture the anchor is the frame you bound it to, else your previous gesture that reached the device (a refused one never anchors), else the last sixty seconds. A person may drive the same device beside an agent's run; each is informed of the other through this and neither is stopped.","isRequired":true,"uniqueKey":"others","typeLabel":"object"}},"required":["ok","others"],"additionalProperties":false,"description":"The action was applied. `others` says what principals other than this run did on the device since the frame the action was bound to; the driver ignores this body, and a worker that reads it looks again before its next decision when `actions` is above zero.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":true,"others":{"actions":123,"lastAt":"2023-11-07T05:31:56Z","by":["person"]}}}},"exampleType":"generated"}},"exampleType":"generated"},"a4a69178-f162-4795-a19e-2ae43c58c5bc":{"description":"The body is not JSON, or the action is malformed.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"ok","typeLabel":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string","enum":["DEVICE_NOT_FOUND","INVALID_ACTION","FRAME_VIEWPORT_MISMATCH","COORDINATE_OUT_OF_REACH","ACTION_UNAVAILABLE","FENCING_TOKEN_STALE","STALE_FRAME","HARDWARE_OFFLINE","FRAME_UNAVAILABLE","ACTION_OUTCOME_UNKNOWN"],"description":"The dialect code to branch on.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A constant summary per branch. Internal error text is never forwarded here.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","description":"Structured detail for the branches that have any (spec §8, §15.4). `STALE_FRAME` carries `reason` (`unknown_frame`, `superseded`, `expired`, `viewport_changed`, `others_acted`; read anything else as `unknown_frame`), and an `ACTION_UNAVAILABLE` raised by a full device queue carries `retryAfterMs`. Absent on every other branch, and it never carries internal text.","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["ok","error"],"additionalProperties":false,"description":"The device surface answers in the dialect's own error shape, not the control surface envelope.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":false,"error":{"code":"DEVICE_NOT_FOUND","message":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"a1044daa-ce59-4d33-bf9a-2897900a1753":{"description":"Unknown, expired, terminal, or addressed at a device this run does not own. All four answer identically, so holding a token tells you nothing about which it was.\n\nIf you reached this with an org API key rather than a run token, the code is misleading and the message says so: nothing is missing, this is the worker channel and your credential does not apply to it. Drive devices yourself over the MCP endpoint instead.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"ok","typeLabel":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string","enum":["DEVICE_NOT_FOUND","INVALID_ACTION","FRAME_VIEWPORT_MISMATCH","COORDINATE_OUT_OF_REACH","ACTION_UNAVAILABLE","FENCING_TOKEN_STALE","STALE_FRAME","HARDWARE_OFFLINE","FRAME_UNAVAILABLE","ACTION_OUTCOME_UNKNOWN"],"description":"The dialect code to branch on.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A constant summary per branch. Internal error text is never forwarded here.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","description":"Structured detail for the branches that have any (spec §8, §15.4). `STALE_FRAME` carries `reason` (`unknown_frame`, `superseded`, `expired`, `viewport_changed`, `others_acted`; read anything else as `unknown_frame`), and an `ACTION_UNAVAILABLE` raised by a full device queue carries `retryAfterMs`. Absent on every other branch, and it never carries internal text.","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["ok","error"],"additionalProperties":false,"description":"The device surface answers in the dialect's own error shape, not the control surface envelope.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":false,"error":{"code":"DEVICE_NOT_FOUND","message":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"45e2bf64-33d5-4185-b5dd-c79751397388":{"description":"The run is no longer driving the device, the frame is superseded, somebody else acted after it and you asked to be refused when they do, the frame size does not match, the lease has moved on, the device has too many actions waiting, or the device cannot do this.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"ok","typeLabel":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string","enum":["DEVICE_NOT_FOUND","INVALID_ACTION","FRAME_VIEWPORT_MISMATCH","COORDINATE_OUT_OF_REACH","ACTION_UNAVAILABLE","FENCING_TOKEN_STALE","STALE_FRAME","HARDWARE_OFFLINE","FRAME_UNAVAILABLE","ACTION_OUTCOME_UNKNOWN"],"description":"The dialect code to branch on.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A constant summary per branch. Internal error text is never forwarded here.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","description":"Structured detail for the branches that have any (spec §8, §15.4). `STALE_FRAME` carries `reason` (`unknown_frame`, `superseded`, `expired`, `viewport_changed`, `others_acted`; read anything else as `unknown_frame`), and an `ACTION_UNAVAILABLE` raised by a full device queue carries `retryAfterMs`. Absent on every other branch, and it never carries internal text.","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["ok","error"],"additionalProperties":false,"description":"The device surface answers in the dialect's own error shape, not the control surface envelope.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":false,"error":{"code":"DEVICE_NOT_FOUND","message":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"49a0d1b3-8cdd-4b52-a3a5-561d73b054a1":{"description":"The request body exceeds the server's limit (1 MiB). Refused before the body is parsed, so nothing was partially applied. Retrying the same body will fail the same way: send less. Per-field limits are tighter than this and are documented on the fields themselves; this is the backstop underneath them. The shape is the same on ordinary JSON surfaces, /vrx included. The explicitly configured APK content stream documents its own byte ceiling.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"payload_too_large","description":"Always `payload_too_large` on this response.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"A human readable summary naming the limit in bytes.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"description":"Returned when the request body exceeds the server limit. Identical on every surface, including /vrx.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"payload_too_large","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"7a0f048f-5570-4d86-8478-9e550c5ce0e5":{"description":"A coordinate is outside the frame.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"ok","typeLabel":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string","enum":["DEVICE_NOT_FOUND","INVALID_ACTION","FRAME_VIEWPORT_MISMATCH","COORDINATE_OUT_OF_REACH","ACTION_UNAVAILABLE","FENCING_TOKEN_STALE","STALE_FRAME","HARDWARE_OFFLINE","FRAME_UNAVAILABLE","ACTION_OUTCOME_UNKNOWN"],"description":"The dialect code to branch on.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A constant summary per branch. Internal error text is never forwarded here.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","description":"Structured detail for the branches that have any (spec §8, §15.4). `STALE_FRAME` carries `reason` (`unknown_frame`, `superseded`, `expired`, `viewport_changed`, `others_acted`; read anything else as `unknown_frame`), and an `ACTION_UNAVAILABLE` raised by a full device queue carries `retryAfterMs`. Absent on every other branch, and it never carries internal text.","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["ok","error"],"additionalProperties":false,"description":"The device surface answers in the dialect's own error shape, not the control surface envelope.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":false,"error":{"code":"DEVICE_NOT_FOUND","message":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"75842588-5591-41c4-82c0-95485a4e3aed":{"description":"Over the request budget for this caller. Hosted deployments only. Which budget applied depends on whether this request carried an `Authorization` header, not on which endpoint it was aimed at. Wait `Retry-After` seconds and retry the same request: the refusal happens before any work, so nothing was partially applied. See /api/rate-limits.","headers":{"Retry-After":{"description":"Whole seconds until one request is available again. Computed from the caller's own remaining allowance, not a fixed constant.","schema":{"type":"string"}},"RateLimit-Limit":{"description":"The budget in effect for this caller class, in requests per minute.","schema":{"type":"string"}},"RateLimit-Remaining":{"description":"Whole requests that were still available when this request was admitted. Zero on a 429.","schema":{"type":"string"}},"RateLimit-Reset":{"description":"Seconds until the allowance is back to full. Longer than `Retry-After`, which is the wait for a single request.","schema":{"type":"string"}},"RateLimit-Policy":{"description":"The budget and its window, as `\u003climit>;w=60`.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"rate_limited","description":"Always `rate_limited` on this response.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"A human readable summary. The numbers are in the headers, not in here.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"description":"Over the request budget. Raised by the rate limiter before any handler runs, which is why its code is not one of the action codes: nothing was attempted, so no action failed.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"rate_limited","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"db3b7a7a-868e-41dd-8382-91012c9ce3fd":{"description":"The device is not reachable.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"ok","typeLabel":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string","enum":["DEVICE_NOT_FOUND","INVALID_ACTION","FRAME_VIEWPORT_MISMATCH","COORDINATE_OUT_OF_REACH","ACTION_UNAVAILABLE","FENCING_TOKEN_STALE","STALE_FRAME","HARDWARE_OFFLINE","FRAME_UNAVAILABLE","ACTION_OUTCOME_UNKNOWN"],"description":"The dialect code to branch on.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A constant summary per branch. Internal error text is never forwarded here.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","description":"Structured detail for the branches that have any (spec §8, §15.4). `STALE_FRAME` carries `reason` (`unknown_frame`, `superseded`, `expired`, `viewport_changed`, `others_acted`; read anything else as `unknown_frame`), and an `ACTION_UNAVAILABLE` raised by a full device queue carries `retryAfterMs`. Absent on every other branch, and it never carries internal text.","additionalProperties":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["ok","error"],"additionalProperties":false,"description":"The device surface answers in the dialect's own error shape, not the control surface envelope.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":false,"error":{"code":"DEVICE_NOT_FOUND","message":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{"0b8b9ab5-c46d-4bb8-88b0-6eeb0d5654ea":{"url":"{origin}","description":"Your control plane origin.","variables":{"origin":{"default":"https://mcp.phoneuse.com","enum":["https://mcp.phoneuse.com","http://127.0.0.1:8788"],"description":"The hosted deployment serves the public origin its metadata document advertises, and that is the default here. Select the loopback entry instead when you are running a local checkout, which serves the port `PORT` names."}}}}},"originalFileLocation":"api/openapi.json"},"subdomain":"phonebase","siteName":"PhoneUse","title":"Act on the device - PhoneUse","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T04:26:05.959Z","originalFileLocation":"api/endpoints/device-surface/act-on-the-device.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Look before you touch: an action is refused until this run has fetched at least one frame, because coordinates with no frame behind them have no meaning. The action is bound to the frame it was decided on. Matching geometry is not enough on its own, since two different screens at the same resolution compare equal, so a superseded frame is refused and you are told to observe again. Retrying a request whose response you lost replays the recorded outcome instead of touching the screen twice. A person may drive the same device beside this run, and their gestures go ahead of the run\u0026#x27;s waiting ones. Every response carries others, what principals other than this run did since the frame this action was bound to, and by default an action is refused STALE_FRAME when that count is above zero: re-observe as you already do. Send refuseIfOthersActed: false to be informed instead of stopped. Gestures on one device run one at a time in arrival order, and a device with too many waiting answers ACTION_UNAVAILABLE; wait and retry, the run is untouched. This operation reads no Authorization header. The run token in the path IS the credential, so the whole url is secret: never log it, paste it, or commit it. Every example writes {runToken} for that reason.\">\u003cmeta data-mint-head name=\"application-name\" content=\"PhoneUse\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/phonebase/kWipq_KjnF--s93A/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/phonebase/kWipq_KjnF--s93A/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/phonebase/kWipq_KjnF--s93A/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/phonebase/kWipq_KjnF--s93A/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/phonebase/kWipq_KjnF--s93A/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/phonebase/kWipq_KjnF--s93A/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/phonebase/kWipq_KjnF--s93A/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/phonebase/kWipq_KjnF--s93A/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/phonebase/kWipq_KjnF--s93A/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Act on the device - PhoneUse\">\u003cmeta data-mint-head property=\"og:description\" content=\"Look before you touch: an action is refused until this run has fetched at least one frame, because coordinates with no frame behind them have no meaning. The action is bound to the frame it was decided on. Matching geometry is not enough on its own, since two different screens at the same resolution compare equal, so a superseded frame is refused and you are told to observe again. Retrying a request whose response you lost replays the recorded outcome instead of touching the screen twice. A person may drive the same device beside this run, and their gestures go ahead of the run\u0026#x27;s waiting ones. Every response carries others, what principals other than this run did since the frame this action was bound to, and by default an action is refused STALE_FRAME when that count is above zero: re-observe as you already do. Send refuseIfOthersActed: false to be informed instead of stopped. Gestures on one device run one at a time in arrival order, and a device with too many waiting answers ACTION_UNAVAILABLE; wait and retry, the run is untouched. This operation reads no Authorization header. The run token in the path IS the credential, so the whole url is secret: never log it, paste it, or commit it. Every example writes {runToken} for that reason.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"PhoneUse\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.phoneuse.com/api/endpoints/device-surface/act-on-the-device\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://phonebase.mintlify.site/_mintlify/api/og/v2?division=Device+surface\u0026amp;title=Act+on+the+device\u0026amp;description=Look+before+you+touch%3A+an+action+is+refused+until+this+run+has+fetched+at+least+one+frame%2C+because+coordinates+with+no+frame+behind+them+have+no+meaning.%0A%0AThe+a\u0026amp;theme=370fb2999dfbb8f85a217f41\u0026amp;signature=a055a6d8c62614507e2d1cc202001d3b0cec23aacbeaee872ca388dfa6c9950f\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Act on the device - PhoneUse\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Look before you touch: an action is refused until this run has fetched at least one frame, because coordinates with no frame behind them have no meaning. The action is bound to the frame it was decided on. Matching geometry is not enough on its own, since two different screens at the same resolution compare equal, so a superseded frame is refused and you are told to observe again. Retrying a request whose response you lost replays the recorded outcome instead of touching the screen twice. A person may drive the same device beside this run, and their gestures go ahead of the run\u0026#x27;s waiting ones. Every response carries others, what principals other than this run did since the frame this action was bound to, and by default an action is refused STALE_FRAME when that count is above zero: re-observe as you already do. Send refuseIfOthersActed: false to be informed instead of stopped. Gestures on one device run one at a time in arrival order, and a device with too many waiting answers ACTION_UNAVAILABLE; wait and retry, the run is untouched. This operation reads no Authorization header. The run token in the path IS the credential, so the whole url is secret: never log it, paste it, or commit it. Every example writes {runToken} for that reason.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://phonebase.mintlify.site/_mintlify/api/og/v2?division=Device+surface\u0026amp;title=Act+on+the+device\u0026amp;description=Look+before+you+touch%3A+an+action+is+refused+until+this+run+has+fetched+at+least+one+frame%2C+because+coordinates+with+no+frame+behind+them+have+no+meaning.%0A%0AThe+a\u0026amp;theme=370fb2999dfbb8f85a217f41\u0026amp;signature=a055a6d8c62614507e2d1cc202001d3b0cec23aacbeaee872ca388dfa6c9950f\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/phonebase/kWipq_KjnF--s93A/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"PhoneUse\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0c6b4f\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.phoneuse.com/api/endpoints/device-surface/act-on-the-device\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/endpoints/device-surface/act-on-the-device.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.phoneuse.com/#organization\",\"name\":\"PhoneUse\",\"url\":\"https://docs.phoneuse.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/phonebase/asSC9ooLxq3ce7AH/images/logo-light.svg?fit=max\u0026auto=format\u0026n=asSC9ooLxq3ce7AH\u0026q=85\u0026s=797a832db8f0e271d5dbd6beba29a27b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.phoneuse.com#website\",\"name\":\"PhoneUse\",\"url\":\"https://docs.phoneuse.com\",\"publisher\":{\"@id\":\"https://docs.phoneuse.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.phoneuse.com/api/endpoints/device-surface/act-on-the-device#webpage\",\"url\":\"https://docs.phoneuse.com/api/endpoints/device-surface/act-on-the-device\",\"name\":\"Act on the device\",\"description\":\"Look before you touch: an action is refused until this run has fetched at least one frame, because coordinates with no frame behind them have no meaning. The action is bound to the frame it was decided on. Matching geometry is not enough on its own, since two different screens at the same resolution compare equal, so a superseded frame is refused and you are told to observe again. Retrying a request whose response you lost replays the recorded outcome instead of touching the screen twice. A person may drive the same device beside this run, and their gestures go ahead of the run's waiting ones. Every response carries others, what principals other than this run did since the frame this action was bound to, and by default an action is refused STALE_FRAME when that count is above zero: re-observe as you already do. Send refuseIfOthersActed: false to be informed instead of stopped. Gestures on one device run one at a time in arrival order, and a device with too many waiting answers ACTION_UNAVAILABLE; wait and retry, the run is untouched. This operation reads no Authorization header. The run token in the path IS the credential, so the whole url is secret: never log it, paste it, or commit it. Every example writes {runToken} for that reason.\",\"dateModified\":\"2026-10-30T04:26:05.959Z\",\"isPartOf\":{\"@id\":\"https://docs.phoneuse.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.phoneuse.com/api/endpoints/device-surface/act-on-the-device#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.phoneuse.com/api/endpoints/device-surface/act-on-the-device#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.phoneuse.com/api/endpoints/health/check-that-the-service-is-up\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Device surface\",\"item\":\"https://docs.phoneuse.com/api/endpoints/device-surface/check-the-runs-device-channel\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Act on the device\",\"item\":\"https://docs.phoneuse.com/api/endpoints/device-surface/act-on-the-device\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.phoneuse.com/api/endpoints/device-surface/act-on-the-device#apireference\",\"headline\":\"Act on the device\",\"name\":\"Act on the device\",\"description\":\"Look before you touch: an action is refused until this run has fetched at least one frame, because coordinates with no frame behind them have no meaning. The action is bound to the frame it was decided on. Matching geometry is not enough on its own, since two different screens at the same resolution compare equal, so a superseded frame is refused and you are told to observe again. Retrying a request whose response you lost replays the recorded outcome instead of touching the screen twice. A person may drive the same device beside this run, and their gestures go ahead of the run's waiting ones. Every response carries others, what principals other than this run did since the frame this action was bound to, and by default an action is refused STALE_FRAME when that count is above zero: re-observe as you already do. Send refuseIfOthersActed: false to be informed instead of stopped. Gestures on one device run one at a time in arrival order, and a device with too many waiting answers ACTION_UNAVAILABLE; wait and retry, the run is untouched. This operation reads no Authorization header. The run token in the path IS the credential, so the whole url is secret: never log it, paste it, or commit it. Every example writes {runToken} for that reason.\",\"url\":\"https://docs.phoneuse.com/api/endpoints/device-surface/act-on-the-device\",\"mainEntityOfPage\":{\"@id\":\"https://docs.phoneuse.com/api/endpoints/device-surface/act-on-the-device#webpage\"},\"dateModified\":\"2026-10-30T04:26:05.959Z\",\"publisher\":{\"@id\":\"https://docs.phoneuse.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.phoneuse.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"PhoneUse\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"PhoneUse\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api/endpoints/device-surface/act-on-the-device.md","siteName":"PhoneUse","nav":{"global":null,"tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":""}]},{"tab":"API","groups":[{"group":"Overview","pages":[{"title":"API overview","href":"/api"},{"title":"Versioning and compatibility","href":"/api/versioning"},{"title":"Rate limits","href":"/api/rate-limits"}]},{"group":"Endpoints","pages":[{"group":"Health","pages":[{"title":"Check that the service is up","deprecated":null,"version":null,"openapi":"/api/openapi.json get /healthz","href":"/api/endpoints/health/check-that-the-service-is-up"}]},{"group":"Device surface","pages":[{"title":"Check the run's device channel","deprecated":null,"version":null,"openapi":"/api/openapi.json get /vrx/{runToken}/v1/health","href":"/api/endpoints/device-surface/check-the-runs-device-channel"},{"title":"List the run's device","deprecated":null,"version":null,"openapi":"/api/openapi.json get /vrx/{runToken}/v1/devices","href":"/api/endpoints/device-surface/list-the-runs-device"},{"title":"Fetch a frame","deprecated":null,"version":null,"openapi":"/api/openapi.json get /vrx/{runToken}/v1/devices/{deviceId}/screenshot","href":"/api/endpoints/device-surface/fetch-a-frame"},{"title":"Report the run's outcome","description":"How a worker says it is done. It lives on this surface rather than on the run surface because a worker holds exactly one credential, its run token, and should never need an org credential to close its own work. The token also pins WHICH run is being reported, so a worker cannot close somebody else's.\n\n`needs_user_control` parks the run for a person, who lifts it through the run surface. Secrets never travel in this body.\n\nOnce a run is parked, only a person can end it: a `succeeded` or `failed` report on a parked run is refused with a 409 until someone resumes or cancels it. Reporting `needs_user_control` again is allowed and only refreshes the handoff instruction.\n\nThis operation reads no `Authorization` header. The run token in the path IS the credential, so the whole url is secret: never log it, paste it, or commit it. Every example writes `{runToken}` for that reason.","deprecated":null,"version":null,"openapi":"/api/openapi.json post /vrx/{runToken}/v1/report","href":"/api/endpoints/device-surface/report-the-runs-outcome"},{"title":"Act on the device","deprecated":null,"version":null,"openapi":"/api/openapi.json post /vrx/{runToken}/v1/devices/{deviceId}/actions","href":"/api/endpoints/device-surface/act-on-the-device"}]},{"group":"MCP","pages":[{"title":"Why there is no event stream","description":"There is no event stream to resume, so this method is refused. The refusal is documented rather than omitted, because a client that expects a stream should learn why it will not get one.","deprecated":null,"version":null,"openapi":"/api/openapi.json get /mcp","href":"/api/endpoints/mcp/why-there-is-no-event-stream"},{"title":"Send a JSON-RPC request","deprecated":null,"version":null,"openapi":"/api/openapi.json post /mcp","href":"/api/endpoints/mcp/send-a-json-rpc-request"},{"title":"Why there is no session to end","deprecated":null,"version":null,"openapi":"/api/openapi.json delete /mcp","href":"/api/endpoints/mcp/why-there-is-no-session-to-end"}]},{"group":"Apps","pages":[{"title":"Discover visible devices and authoritative application scopes","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/app-library/device-capabilities","href":"/api/endpoints/apps/discover-visible-devices-and-authoritative-application-scopes"},{"title":"Read last confirmed phone apps","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/app-library/inventory","href":"/api/endpoints/apps/read-last-confirmed-phone-apps"},{"title":"Request bounded read-only application checks","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/app-library/inventory/refreshes","href":"/api/endpoints/apps/request-bounded-read-only-application-checks"},{"title":"Read application-check progress","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/app-library/inventory/refreshes/{refreshId}","href":"/api/endpoints/apps/read-application-check-progress"},{"title":"Read per-device check outcomes","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/app-library/inventory/refreshes/{refreshId}/results","href":"/api/endpoints/apps/read-per-device-check-outcomes"},{"title":"Recover a lost mutation response by original key","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/app-library/requests/{requestKey}","href":"/api/endpoints/apps/recover-a-lost-mutation-response-by-original-key"},{"title":"List installable apps","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/app-store/catalog","href":"/api/endpoints/apps/list-installable-apps"},{"title":"Read installation history","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/app-store/installations","href":"/api/endpoints/apps/read-installation-history"},{"title":"Install an app","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/app-store/installations","href":"/api/endpoints/apps/install-an-app"},{"title":"Recover an app installation","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/app-store/installations/by-request/{requestKey}","href":"/api/endpoints/apps/recover-an-app-installation"},{"title":"Check an app installation","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/app-store/installations/{installationId}","href":"/api/endpoints/apps/check-an-app-installation"},{"title":"Check an app installation again","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/app-store/installations/{installationId}/recheck","href":"/api/endpoints/apps/check-an-app-installation-again"},{"title":"Skip checking an unconfirmed installation","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/app-store/installations/{installationId}/skip","href":"/api/endpoints/apps/skip-checking-an-unconfirmed-installation"},{"title":"Read a phone's install queue","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/app-store/queue","href":"/api/endpoints/apps/read-a-phones-install-queue"},{"title":"Add an app to a phone's install queue","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/app-store/queue","href":"/api/endpoints/apps/add-an-app-to-a-phones-install-queue"},{"title":"Recover a queued app by its request key","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/app-store/queue/by-request/{requestKey}","href":"/api/endpoints/apps/recover-a-queued-app-by-its-request-key"},{"title":"Remove a waiting app from a phone's queue","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/app-store/queue/{entryId}/remove","href":"/api/endpoints/apps/remove-a-waiting-app-from-a-phones-queue"},{"title":"Pause or resume a phone's install queue","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/app-store/queue/pause","href":"/api/endpoints/apps/pause-or-resume-a-phones-install-queue"}]},{"group":"Runs","pages":[{"title":"Get a short-lived URL for one archived frame","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/frames/{frameId}","href":"/api/endpoints/runs/get-a-short-lived-url-for-one-archived-frame"},{"title":"List your runs","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/runs","href":"/api/endpoints/runs/list-your-runs"},{"title":"Start a run on a device","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/runs","href":"/api/endpoints/runs/start-a-run-on-a-device"},{"title":"Read a run, optionally waiting for it to move","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/runs/{runId}","href":"/api/endpoints/runs/read-a-run-optionally-waiting-for-it-to-move"},{"title":"Put a run on hold","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/runs/{runId}/pause","href":"/api/endpoints/runs/put-a-run-on-hold"},{"title":"Lift a stop and let the run carry on","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/runs/{runId}/resume","href":"/api/endpoints/runs/lift-a-stop-and-let-the-run-carry-on"},{"title":"Cancel a run","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/runs/{runId}/cancel","href":"/api/endpoints/runs/cancel-a-run"}]},{"group":"Discovery","pages":[{"title":"Discover where to authenticate","deprecated":null,"version":null,"openapi":"/api/openapi.json get /.well-known/oauth-protected-resource","href":"/api/endpoints/discovery/discover-where-to-authenticate"},{"title":"Discover where to authenticate, at the endpoint suffixed path","deprecated":null,"version":null,"openapi":"/api/openapi.json get /.well-known/oauth-protected-resource/mcp","href":"/api/endpoints/discovery/discover-where-to-authenticate-at-the-endpoint-suffixed-path"}]},{"group":"API keys","pages":[{"title":"List the org's keys","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/api-keys","href":"/api/endpoints/api-keys/list-the-orgs-keys"},{"title":"Mint an API key","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/api-keys","href":"/api/endpoints/api-keys/mint-an-api-key"},{"title":"Describe the calling key","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/api-keys/current","href":"/api/endpoints/api-keys/describe-the-calling-key"},{"title":"Revoke the calling key","deprecated":null,"version":null,"openapi":"/api/openapi.json delete /v1/api-keys/current","href":"/api/endpoints/api-keys/revoke-the-calling-key"},{"title":"Revoke a key","deprecated":null,"version":null,"openapi":"/api/openapi.json delete /v1/api-keys/{id}","href":"/api/endpoints/api-keys/revoke-a-key"},{"title":"Rename, renew or narrow a key","deprecated":null,"version":null,"openapi":"/api/openapi.json patch /v1/api-keys/{id}","href":"/api/endpoints/api-keys/rename-renew-or-narrow-a-key"},{"title":"Rotate a key","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/api-keys/{id}/rotate","href":"/api/endpoints/api-keys/rotate-a-key"},{"title":"Start a CLI sign-in","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/cli-sessions","href":"/api/endpoints/api-keys/start-a-cli-sign-in"},{"title":"Poll a CLI sign-in, and collect its key","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/cli-sessions/token","href":"/api/endpoints/api-keys/poll-a-cli-sign-in-and-collect-its-key"},{"title":"Look at a CLI sign-in before approving it","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/cli-sessions/{userCode}","href":"/api/endpoints/api-keys/look-at-a-cli-sign-in-before-approving-it"},{"title":"Approve a CLI sign-in","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/cli-sessions/{userCode}/approve","href":"/api/endpoints/api-keys/approve-a-cli-sign-in"},{"title":"Deny a CLI sign-in","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/cli-sessions/{userCode}/deny","href":"/api/endpoints/api-keys/deny-a-cli-sign-in"}]},{"group":"Usage","pages":[{"title":"List your org's receipts","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/receipts","href":"/api/endpoints/usage/list-your-orgs-receipts"},{"title":"Read one receipt","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/receipts/{idempotencyKey}","href":"/api/endpoints/usage/read-one-receipt"},{"title":"Mark a receipt reviewed","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/receipts/{idempotencyKey}/reviewed","href":"/api/endpoints/usage/mark-a-receipt-reviewed"},{"title":"List a phone's unclear actions","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/devices/{deviceId}/unclear-actions","href":"/api/endpoints/usage/list-a-phones-unclear-actions"},{"title":"Confirm a phone looks right","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/devices/{deviceId}/unclear-actions/confirm","href":"/api/endpoints/usage/confirm-a-phone-looks-right"},{"title":"Read your org's usage this period","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/usage","href":"/api/endpoints/usage/read-your-orgs-usage-this-period"}]},{"group":"Devices","pages":[{"title":"Small pictures of several devices' screens","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/device-thumbnails","href":"/api/endpoints/devices/small-pictures-of-several-devices-screens"},{"title":"List the devices you can see","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/devices","href":"/api/endpoints/devices/list-the-devices-you-can-see"},{"title":"Read one device","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/devices/{deviceId}","href":"/api/endpoints/devices/read-one-device"},{"title":"Rename a device","deprecated":null,"version":null,"openapi":"/api/openapi.json patch /v1/devices/{deviceId}","href":"/api/endpoints/devices/rename-a-device"},{"title":"Look at a device's screen","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/devices/{deviceId}/screenshot","href":"/api/endpoints/devices/look-at-a-devices-screen"},{"title":"Live video fault observation","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/devices/{deviceId}/image-maintenance/fault","href":"/api/endpoints/devices/live-video-fault-observation"},{"title":"Saved recovery plan cancellation","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/devices/{deviceId}/image-maintenance/cancel","href":"/api/endpoints/devices/saved-recovery-plan-cancellation"},{"title":"Original recovery result recheck","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/devices/{deviceId}/image-maintenance/recheck","href":"/api/endpoints/devices/original-recovery-result-recheck"},{"title":"Image recovery progress and availability","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/devices/{deviceId}/image-maintenance","href":"/api/endpoints/devices/image-recovery-progress-and-availability"},{"title":"Take a device","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/devices/{deviceId}/lease","href":"/api/endpoints/devices/take-a-device"},{"title":"Give a device back","deprecated":null,"version":null,"openapi":"/api/openapi.json delete /v1/devices/{deviceId}/lease","href":"/api/endpoints/devices/give-a-device-back"},{"title":"Keep a device longer","deprecated":null,"version":null,"openapi":"/api/openapi.json patch /v1/devices/{deviceId}/lease","href":"/api/endpoints/devices/keep-a-device-longer"},{"title":"Act on a device","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/devices/{deviceId}/actions","href":"/api/endpoints/devices/act-on-a-device"},{"title":"Who is driving a device","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/devices/{deviceId}/driving","href":"/api/endpoints/devices/who-is-driving-a-device"},{"title":"Open a live video session on a device","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/devices/{deviceId}/live-session","href":"/api/endpoints/devices/open-a-live-video-session-on-a-device"},{"title":"Wake a device's screen","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/devices/{deviceId}/wake","href":"/api/endpoints/devices/wake-a-devices-screen"},{"title":"Open a live view of a device","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/devices/{deviceId}/stream","href":"/api/endpoints/devices/open-a-live-view-of-a-device"},{"title":"Read the server's clock","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/time","href":"/api/endpoints/devices/read-the-servers-clock"},{"title":"List the devices your organisation currently holds","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/leases","href":"/api/endpoints/devices/list-the-devices-your-organisation-currently-holds"}]},{"group":"Copilot","pages":[{"title":"Ask the copilot","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/copilot","href":"/api/endpoints/copilot/ask-the-copilot"},{"title":"Answer a copilot approval","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/copilot/approvals","href":"/api/endpoints/copilot/answer-a-copilot-approval"},{"title":"Run one tool the person named","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/copilot/commands","href":"/api/endpoints/copilot/run-one-tool-the-person-named"},{"title":"Stop the turn this thread is running","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/copilot/threads/{id}/stop","href":"/api/endpoints/copilot/stop-the-turn-this-thread-is-running"},{"title":"Pick a cut copilot stream back up","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/copilot/threads/{id}/stream","href":"/api/endpoints/copilot/pick-a-cut-copilot-stream-back-up"},{"title":"Your copilot threads","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/copilot/threads","href":"/api/endpoints/copilot/your-copilot-threads"},{"title":"One thread, with a page of its messages","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/copilot/threads/{id}","href":"/api/endpoints/copilot/one-thread-with-a-page-of-its-messages"},{"title":"Delete a thread","deprecated":null,"version":null,"openapi":"/api/openapi.json delete /v1/copilot/threads/{id}","href":"/api/endpoints/copilot/delete-a-thread"},{"title":"Rename a thread","deprecated":null,"version":null,"openapi":"/api/openapi.json patch /v1/copilot/threads/{id}","href":"/api/endpoints/copilot/rename-a-thread"}]},{"group":"Webhooks","pages":[{"title":"Your webhook subscriptions","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/webhooks","href":"/api/endpoints/webhooks/your-webhook-subscriptions"},{"title":"Subscribe your system to what happens here","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/webhooks","href":"/api/endpoints/webhooks/subscribe-your-system-to-what-happens-here"},{"title":"Remove a subscription","deprecated":null,"version":null,"openapi":"/api/openapi.json delete /v1/webhooks/{webhookId}","href":"/api/endpoints/webhooks/remove-a-subscription"},{"title":"Enable or disable a subscription","deprecated":null,"version":null,"openapi":"/api/openapi.json patch /v1/webhooks/{webhookId}","href":"/api/endpoints/webhooks/enable-or-disable-a-subscription"},{"title":"Replace a signing secret","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/webhooks/{webhookId}/rotate","href":"/api/endpoints/webhooks/replace-a-signing-secret"},{"title":"Send a test delivery","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/webhooks/{webhookId}/test","href":"/api/endpoints/webhooks/send-a-test-delivery"},{"title":"What was delivered, and what happened","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/webhooks/{webhookId}/deliveries","href":"/api/endpoints/webhooks/what-was-delivered-and-what-happened"}]},{"group":"Robot purchases","pages":[{"title":"List your robot purchases","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/robot-purchases","href":"/api/endpoints/robot-purchases/list-your-robot-purchases"},{"title":"Read the monthly robot checkout offer","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/robot-purchases/offer","href":"/api/endpoints/robot-purchases/read-the-monthly-robot-checkout-offer"},{"title":"Open the original monthly robot checkout","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/robot-purchases/checkout","href":"/api/endpoints/robot-purchases/open-the-original-monthly-robot-checkout"},{"title":"Read your initial robot purchase receipt","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/robot-purchases/{orderId}","href":"/api/endpoints/robot-purchases/read-your-initial-robot-purchase-receipt"}]},{"group":"Managed Proxy","pages":[{"title":"Quote a multi-unit Proxy purchase","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/proxy-purchase-quotes","href":"/api/endpoints/managed-proxy/quote-a-multi-unit-proxy-purchase"},{"title":"Read the original purchase agreement","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/proxy-purchase-quotes/{quoteId}","href":"/api/endpoints/managed-proxy/read-the-original-purchase-agreement"},{"title":"Accept the original multi-unit purchase agreement","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/proxy-purchases","href":"/api/endpoints/managed-proxy/accept-the-original-multi-unit-purchase-agreement"},{"title":"Read unit delivery and original payment facts","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/proxy-purchases/{purchaseId}","href":"/api/endpoints/managed-proxy/read-unit-delivery-and-original-payment-facts"},{"title":"Cancel original undelivered units","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/proxy-purchases/{purchaseId}/cancel","href":"/api/endpoints/managed-proxy/cancel-original-undelivered-units"},{"title":"List managed Proxy products","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/proxy-products","href":"/api/endpoints/managed-proxy/list-managed-proxy-products"},{"title":"Read a managed Proxy product","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/proxy-products/{productId}","href":"/api/endpoints/managed-proxy/read-a-managed-proxy-product"},{"title":"Quote a managed Proxy purchase","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/proxy-quotes","href":"/api/endpoints/managed-proxy/quote-a-managed-proxy-purchase"},{"title":"Read the original quote","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/proxy-quotes/{quoteId}","href":"/api/endpoints/managed-proxy/read-the-original-quote"},{"title":"List your Proxy orders","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/proxy-orders","href":"/api/endpoints/managed-proxy/list-your-proxy-orders"},{"title":"Reserve a quoted Proxy order","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/proxy-orders","href":"/api/endpoints/managed-proxy/reserve-a-quoted-proxy-order"},{"title":"Read a Proxy order and its settlement","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/proxy-orders/{orderId}","href":"/api/endpoints/managed-proxy/read-a-proxy-order-and-its-settlement"},{"title":"Request hosted Checkout for an order","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/proxy-orders/{orderId}/checkout","href":"/api/endpoints/managed-proxy/request-hosted-checkout-for-an-order"},{"title":"Cancel a Proxy order","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/proxy-orders/{orderId}/cancel","href":"/api/endpoints/managed-proxy/cancel-a-proxy-order"},{"title":"List your managed Proxies","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/proxies","href":"/api/endpoints/managed-proxy/list-your-managed-proxies"},{"title":"Read a managed Proxy","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/proxies/{proxyId}","href":"/api/endpoints/managed-proxy/read-a-managed-proxy"},{"title":"Rename a managed Proxy","deprecated":null,"version":null,"openapi":"/api/openapi.json patch /v1/proxies/{proxyId}","href":"/api/endpoints/managed-proxy/rename-a-managed-proxy"},{"title":"Archive an expired detached Proxy","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/proxies/{proxyId}/archive","href":"/api/endpoints/managed-proxy/archive-an-expired-detached-proxy"},{"title":"List your Proxy network operations","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/proxy-operations","href":"/api/endpoints/managed-proxy/list-your-proxy-network-operations"},{"title":"Connect or disconnect a Proxy","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/proxy-operations","href":"/api/endpoints/managed-proxy/connect-or-disconnect-a-proxy"},{"title":"Read a Proxy operation","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/proxy-operations/{operationId}","href":"/api/endpoints/managed-proxy/read-a-proxy-operation"},{"title":"Read a device's confirmed Proxy relationship","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/devices/{deviceId}/proxy","href":"/api/endpoints/managed-proxy/read-a-devices-confirmed-proxy-relationship"}]},{"group":"Minute billing","pages":[{"title":"/v1/minute/requests/:requestId","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/minute/requests/{requestId}","href":"/api/endpoints/minute-billing/v1minuterequests:requestid"},{"title":"/v1/minute/catalog","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/minute/catalog","href":"/api/endpoints/minute-billing/v1minutecatalog"},{"title":"/v1/minute/wallet","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/minute/wallet","href":"/api/endpoints/minute-billing/v1minutewallet"},{"title":"/v1/minute/topup-quotes","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/minute/topup-quotes","href":"/api/endpoints/minute-billing/v1minutetopup-quotes"},{"title":"/v1/minute/topups","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/minute/topups","href":"/api/endpoints/minute-billing/v1minutetopups"},{"title":"/v1/minute/topups/:id","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/minute/topups/{id}","href":"/api/endpoints/minute-billing/v1minutetopups:id"},{"title":"/v1/minute/topups/:id/abandon","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/minute/topups/{id}/abandon","href":"/api/endpoints/minute-billing/v1minutetopups:idabandon"},{"title":"/v1/minute/starts","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/minute/starts","href":"/api/endpoints/minute-billing/v1minutestarts"},{"title":"/v1/minute/starts/:id","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/minute/starts/{id}","href":"/api/endpoints/minute-billing/v1minutestarts:id"},{"title":"/v1/minute/orders","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/minute/orders","href":"/api/endpoints/minute-billing/v1minuteorders"},{"title":"/v1/minute/orders","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/minute/orders","href":"/api/endpoints/minute-billing/v1minuteorders-1"},{"title":"/v1/minute/orders/:id","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/minute/orders/{id}","href":"/api/endpoints/minute-billing/v1minuteorders:id"},{"title":"/v1/minute/orders/:id/cancel","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/minute/orders/{id}/cancel","href":"/api/endpoints/minute-billing/v1minuteorders:idcancel"},{"title":"/v1/minute/rentals/:deviceId","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/minute/rentals/{deviceId}","href":"/api/endpoints/minute-billing/v1minuterentals:deviceid"},{"title":"/v1/minute/rentals/:deviceId/return","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/minute/rentals/{deviceId}/return","href":"/api/endpoints/minute-billing/v1minuterentals:deviceidreturn"},{"title":"/v1/minute/rentals/:deviceId/resume","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/minute/rentals/{deviceId}/resume","href":"/api/endpoints/minute-billing/v1minuterentals:deviceidresume"},{"title":"/v1/minute/refunds","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/minute/refunds","href":"/api/endpoints/minute-billing/v1minuterefunds"},{"title":"/v1/minute/refunds","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/minute/refunds","href":"/api/endpoints/minute-billing/v1minuterefunds-1"},{"title":"/v1/minute/cases","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/minute/cases","href":"/api/endpoints/minute-billing/v1minutecases"},{"title":"/v1/minute/cases","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/minute/cases","href":"/api/endpoints/minute-billing/v1minutecases-1"},{"title":"/v1/minute/cases/:id","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/minute/cases/{id}","href":"/api/endpoints/minute-billing/v1minutecases:id"},{"title":"/v1/minute/refunds/:id","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/minute/refunds/{id}","href":"/api/endpoints/minute-billing/v1minuterefunds:id"}]},{"group":"Provisioning","pages":[{"title":"Check whether your organisation is provisioned","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/admission","href":"/api/endpoints/provisioning/check-whether-your-organisation-is-provisioned"},{"title":"What your organisation has bought, and where each purchase got to","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/fulfilments","href":"/api/endpoints/provisioning/what-your-organisation-has-bought-and-where-each-purchase-got-to"},{"title":"Whether one checkout was paid","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/orders/{orderId}/payment-status","href":"/api/endpoints/provisioning/whether-one-checkout-was-paid"},{"title":"Cancelling online is retired: contact support","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/fulfilments/{id}/cancel","href":"/api/endpoints/provisioning/cancelling-online-is-retired:-contact-support"},{"title":"Returning online is retired: contact support","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/fulfilments/{id}/return","href":"/api/endpoints/provisioning/returning-online-is-retired:-contact-support"},{"title":"Stop future Cloud phone renewal at Stripe's current period end","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/fulfilments/{id}/cancel-renewal","href":"/api/endpoints/provisioning/stop-future-cloud-phone-renewal-at-stripes-current-period-end"},{"title":"Read a Cloud phone's current monthly renewal state","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/fulfilments/{id}/renewal-status","href":"/api/endpoints/provisioning/read-a-cloud-phones-current-monthly-renewal-state"},{"title":"What you owe next","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/billing/upcoming","href":"/api/endpoints/provisioning/what-you-owe-next"},{"title":"Open the billing portal","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/billing/portal-sessions","href":"/api/endpoints/provisioning/open-the-billing-portal"},{"title":"List what can be bought and what it costs","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/skus","href":"/api/endpoints/provisioning/list-what-can-be-bought-and-what-it-costs"},{"title":"Start provisioning this organisation","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/checkout-sessions","href":"/api/endpoints/provisioning/start-provisioning-this-organisation"},{"title":"Check one returned Checkout now","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/checkout-sessions/{orderId}/confirm","href":"/api/endpoints/provisioning/check-one-returned-checkout-now"},{"title":"Where the payment provider delivers","deprecated":null,"version":null,"openapi":"/api/openapi.json post /webhooks/stripe","href":"/api/endpoints/provisioning/where-the-payment-provider-delivers"},{"title":"Where the identity provider delivers","deprecated":null,"version":null,"openapi":"/api/openapi.json post /webhooks/clerk","href":"/api/endpoints/provisioning/where-the-identity-provider-delivers"}]},{"group":"Notifications","pages":[{"title":"The bell, and the list behind it","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/notifications","href":"/api/endpoints/notifications/the-bell-and-the-list-behind-it"},{"title":"Mark notifications read","deprecated":null,"version":null,"openapi":"/api/openapi.json post /v1/notifications/read","href":"/api/endpoints/notifications/mark-notifications-read"},{"title":"Which emails you receive","deprecated":null,"version":null,"openapi":"/api/openapi.json get /v1/me/notification-preferences","href":"/api/endpoints/notifications/which-emails-you-receive"},{"title":"Change which emails you receive","deprecated":null,"version":null,"openapi":"/api/openapi.json patch /v1/me/notification-preferences","href":"/api/endpoints/notifications/change-which-emails-you-receive"}]}]}]},{"tab":"Help","pages":[{"title":"Help","href":"/help/overview"}]}]},"basePath":"","title":"Act on the device - PhoneUse","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","CodeSnippet-eoRjC4Le.js","getApiPlaygroundDisplay-CZyAPlR2.js","Page-Cr9IwkK7.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}