A valid request URL is required to generate request examples{
"installation": {
"installationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requestKey": "<string>",
"appId": "<string>",
"buildId": "<string>",
"name": "<string>",
"packageName": "<string>",
"versionName": "<string>",
"deviceId": "<string>",
"scopeId": "user_0",
"status": "queued",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"receiptId": "<string>",
"reasonCode": "<string>",
"verifiedAt": "2023-11-07T05:31:56Z"
}
}{
"error": {
"code": "preview_changed",
"message": "A selected device has changed. Review the devices again.",
"requestId": "req_01",
"field": null,
"retry": "new_preview",
"retryAfterSeconds": null
}
}{
"error": {
"code": "preview_changed",
"message": "A selected device has changed. Review the devices again.",
"requestId": "req_01",
"field": null,
"retry": "new_preview",
"retryAfterSeconds": null
}
}{
"error": {
"code": "preview_changed",
"message": "A selected device has changed. Review the devices again.",
"requestId": "req_01",
"field": null,
"retry": "new_preview",
"retryAfterSeconds": null
}
}{
"error": {
"code": "preview_changed",
"message": "A selected device has changed. Review the devices again.",
"requestId": "req_01",
"field": null,
"retry": "new_preview",
"retryAfterSeconds": null
}
}{
"error": {
"code": "preview_changed",
"message": "A selected device has changed. Review the devices again.",
"requestId": "req_01",
"field": null,
"retry": "new_preview",
"retryAfterSeconds": null
}
}{
"error": {
"code": "payload_too_large",
"message": "<string>"
}
}{
"error": {
"code": "rate_limited",
"message": "<string>"
}
}{
"error": {
"code": "preview_changed",
"message": "A selected device has changed. Review the devices again.",
"requestId": "req_01",
"field": null,
"retry": "new_preview",
"retryAfterSeconds": null
}
}Skip checking an unconfirmed installation
Managed Android app store. Requires apps:read, devices:read, devices:act, devices:lease. A signed-in person (never an API key) who has looked at the phone stops the checking of an installation whose result is still unconfirmed. The installation ends Failed with reasonCode skipped_by_person, which means only that nobody will confirm it: the app may in fact be on the phone. Its phone hold is released so the phone responds again and its install queue moves on. Who skipped it and when is kept. Nothing is sent, resent or uninstalled. Only an unconfirmed installation that is not being checked right now can be skipped (409 precondition_failed otherwise, also while another action holds the phone for a moment: try again); skipping again returns it unchanged. 503 feature_unavailable where this deployment cannot skip.
A valid request URL is required to generate request examples{
"installation": {
"installationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"requestKey": "<string>",
"appId": "<string>",
"buildId": "<string>",
"name": "<string>",
"packageName": "<string>",
"versionName": "<string>",
"deviceId": "<string>",
"scopeId": "user_0",
"status": "queued",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"receiptId": "<string>",
"reasonCode": "<string>",
"verifiedAt": "2023-11-07T05:31:56Z"
}
}{
"error": {
"code": "preview_changed",
"message": "A selected device has changed. Review the devices again.",
"requestId": "req_01",
"field": null,
"retry": "new_preview",
"retryAfterSeconds": null
}
}{
"error": {
"code": "preview_changed",
"message": "A selected device has changed. Review the devices again.",
"requestId": "req_01",
"field": null,
"retry": "new_preview",
"retryAfterSeconds": null
}
}{
"error": {
"code": "preview_changed",
"message": "A selected device has changed. Review the devices again.",
"requestId": "req_01",
"field": null,
"retry": "new_preview",
"retryAfterSeconds": null
}
}{
"error": {
"code": "preview_changed",
"message": "A selected device has changed. Review the devices again.",
"requestId": "req_01",
"field": null,
"retry": "new_preview",
"retryAfterSeconds": null
}
}{
"error": {
"code": "preview_changed",
"message": "A selected device has changed. Review the devices again.",
"requestId": "req_01",
"field": null,
"retry": "new_preview",
"retryAfterSeconds": null
}
}{
"error": {
"code": "payload_too_large",
"message": "<string>"
}
}{
"error": {
"code": "rate_limited",
"message": "<string>"
}
}{
"error": {
"code": "preview_changed",
"message": "A selected device has changed. Review the devices again.",
"requestId": "req_01",
"field": null,
"retry": "new_preview",
"retryAfterSeconds": null
}
}Authorizations
The control surface credential. Send Authorization: Bearer <token>.
Two kinds of token are accepted and they are told apart by shape, not by a separate header. A token beginning pbk_ or puk_ is an org scoped API key, whose public half and secret half are generated together and of which only a hash of the secret is ever stored; anything else is treated as an OAuth 2.1 access token and verified against the authorization server's keys.
Both resolve to the same context: an org, a principal and a set of scopes. Nothing downstream branches on which channel you used, with one deliberate exception, key management, which requires a signed-in person so that a key can never mint another key.
Scopes are enforced when MCP tools are REGISTERED rather than when they are called, so a tool your credential cannot use is absent from tools/list rather than refused mid gesture.