Reference
catalog
What can be requested: device types and OS versions per platform. Index · shared schemas · errors.
| Procedure | Summary | REST | MCP tool | Stability |
|---|---|---|---|---|
catalog.deviceTypes | List the device types and profiles for a platform | GET | catalog_deviceTypes | stable |
catalog.osVersions | List the OS versions for a platform, with installed and an install command | GET | catalog_osVersions | stable |
catalog.deviceTypes
List the device types and profiles for a platform
| REST | GET /v1/catalog/device-types (input as query parameters) |
| RPC | /rpc/v2/catalog/deviceTypes |
| MCP | tool catalog_deviceTypes; hints: read-only, idempotent |
| Auth | devices:read |
| Tenancy | none |
| Troupe Cloud | answered by the control plane |
| Stability | stable, since 1.0 |
Input:
{ platform: PlatformId }Output:
{ deviceTypes: DeviceType[] }Errors: U, E, CAPABILITY_UNSUPPORTED.
Named types: DeviceType, PlatformId.
catalog.osVersions
List the OS versions for a platform, with installed and an install command
| REST | GET /v1/catalog/os-versions (input as query parameters) |
| RPC | /rpc/v2/catalog/osVersions |
| MCP | tool catalog_osVersions; hints: read-only, idempotent |
| Auth | devices:read |
| Tenancy | none |
| Troupe Cloud | answered by the control plane |
| Stability | stable, since 1.0 |
Input:
{ platform: PlatformId }Output:
{ osVersions: OsVersion[] }Errors: U, E, CAPABILITY_UNSUPPORTED.
Named types: OsVersion, PlatformId.