---
title: "Get device agent manifest"
method: GET
path: "/api/devices/agent/manifest"
tags: ["Devices"]
---

# Get device agent manifest

`GET /api/devices/agent/manifest`

## Request

- Base URL: `https://aximo.autify.com`
- URL: `https://aximo.autify.com/api/devices/agent/manifest`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/autify/apis/aximo-api/docs/api/devices/agent/manifest/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the current version and checksums of the on-device agent assets.
The aximo CLI uses this to decide whether its cached agent files are up
to date before downloading them via `GET /api/devices/agent/{file}`.

## Response `200`

Agent manifest.

- object
  - `manifestVersion` integer, required
  - `version` string, required: Short hash identifying this agent build.
  - `script` object, required
    - `sha256` string, required
    - `size` integer, required: Size in bytes.
  - `requirements` object, required
    - `sha256` string, required
    - `size` integer, required: Size in bytes.
  - `python` object: On-prem deployments only; the embedded Python archive to fetch from `GET /api/devices/agent/bundle/{path}`.
  - `wheels` object[]: On-prem deployments only; agent wheels to fetch from `GET /api/devices/agent/bundle/{path}`.
  - `cli` object: On-prem deployments only; the aximo-cli executables available from the bundle route.
  - `minCliVersion` string: On-prem deployments only; the oldest CLI version the server accepts.

## Other responses

- `401`: Missing or invalid API key.
- `403`: API key is not scoped to an organization, the user is banned, or the user is no longer a member of the organization.
- `404`: BYOD is not enabled for the organization.
- `429`: Rate limit exceeded — e.g. the daily session limit was reached for the organization, or too many API requests were sent in a short window (retry after the number of seconds in the `Retry-After` header).
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/autify/apis/aximo-api.md) - [All operations](https://skmtc.dev/autify/apis/aximo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/autify/apis/aximo-api/revisions/590722011284?raw)