Error

A valid request URL is required to generate request examples

{
  "items": [
    {
      "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"
    }
  ],
  "activeItems": [
    {
      "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"
    }
  ],
  "nextCursor": "<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
  }
}

{
  "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": "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
  }
}

Apps

Read installation history

Managed Android app store. Requires apps:read, devices:read. Catalogue sources stay on the server. Accepted installs persist before the worker uses native action governance, leases and receipts. After uncertain dispatch only original-receipt and fresh inventory reads run; no automatic reinstall. Installed requires verified exact phone, primary profile, package and catalogue version. All history is tenant/device scoped; activeItems repeats every held installation on each bounded page.

GET

app-store

installations

Error

A valid request URL is required to generate request examples

{
  "items": [
    {
      "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"
    }
  ],
  "activeItems": [
    {
      "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"
    }
  ],
  "nextCursor": "<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
  }
}

{
  "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": "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
  }
}

Authorizations

Authorization

string

header

required

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_ 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.

Query Parameters

deviceId

string

Optional currently owned phone.

Required string length: 1 - 160

scopeId

string

Primary Android profile.

Allowed value: "user_0"

limit

integer

Bounded recent history page size, default50.

Required range: 1 <= x <= 100

cursor

string

Original bounded history cursor.

Maximum string length: 4096

Response

Current managed store state.

items

object[]

required

Maximum array length: 100

Show child attributes

activeItems

object[]

required

Maximum array length: 50

Show child attributes

nextCursor

string | null

required

Overview

Endpoints

Read installation history

Authorizations

Query Parameters

Response