Skip to main content
GET
/
deployments
Python
from miru_server_sdk import Miru

client = Miru(
    api_key="My API Key",
)
deployments = client.deployments.list()
print(deployments)
{
  "object": "list",
  "total_count": 123,
  "limit": 10,
  "offset": 0,
  "has_more": false,
  "data": [
    {
      "object": "deployment",
      "id": "dpl_123",
      "description": "Deployment for the motion control config instance",
      "status": "validating",
      "activity_status": "validating",
      "error_status": "none",
      "target_status": "staged",
      "device_id": "dvc_123",
      "release_id": "v1.0.0",
      "created_at": "2024-01-01T00:00:00Z",
      "updated_at": "2024-01-01T00:00:00Z",
      "device": null,
      "release": null,
      "config_instances": [
        {
          "object": "config_instance",
          "id": "cfg_inst_123",
          "target_status": "created",
          "activity_status": "created",
          "error_status": "none",
          "status": "created",
          "relative_filepath": "/v1/motion-control.json",
          "created_at": "2021-01-01T00:00:00Z",
          "updated_at": "2021-01-01T00:00:00Z",
          "device_id": "dvc_123",
          "config_schema_id": "cfg_sch_123",
          "config_type_id": "cfg_type_123",
          "device": null,
          "config_schema": null,
          "content": {
            "enable_autonomy": true,
            "enable_remote_control": false,
            "max_payload_kg": 8.5,
            "preferred_speed_mode": "normal",
            "emergency_stop_sensitivity": 0.9,
            "telemetry": {
              "upload_interval_sec": 45,
              "heartbeat_interval_sec": 15
            }
          },
          "config_type": null
        }
      ]
    }
  ]
}
This API version has reached end of life. See supported versions.
ScopeRequired
deployments:readYes

Authorizations

​
X-API-Key
string
header
required

The API key to use for authentication. Retrieve your API key from the Miru dashboard.

Query Parameters

​
offset
integer
default:0

The offset of the items to return. An offset of 10 with a limit of 10 returns items 11-20.

Required range: x >= 0
​
limit
integer
default:10

The maximum number of items to return. A limit of 15 with an offset of 0 returns items 1-15.

Required range: 1 <= x <= 100
​
order_by
enum<string>
default:created_at:desc

The order to sort the deployments.

Available options:
id:asc,
id:desc,
created_at:desc,
created_at:asc
​
expand[]
enum<string>[]

The fields to expand in the deployments list.

Available options:
total_count,
device,
release,
config_instances
​
id
string

The deployment ID to filter by.

Example:

"dpl_123"

​
target_status
enum<string>

The deployment target status to filter by. Desired state of the deployment.

  • Staged: is ready to be deployed
  • Deployed: all config instances part of the deployment are available for consumption on the device
  • Archived: the deployment is available for historical reference but cannot be deployed and is not active on the device
Available options:
staged,
deployed,
archived
​
activity_status
enum<string>

The deployment activity status to filter by. Last known activity state of the deployment.

  • Validating: the deployment's config instances are being validated with user's custom validation
  • Needs review: deployment needs to be reviewed before it can be deployed
  • Staged: is ready to be deployed
  • Queued: the deployment's config instances are waiting to be received by the device; will be deployed as soon as the device is online
  • Deployed: the deployment's config instances are currently available for consumption on the device
  • Removing: the deployment's config instances are being removed from the device
  • Archived: the deployment is available for historical reference but cannot be deployed and is not active on the device
Available options:
validating,
needs_review,
staged,
queued,
deployed,
removing,
archived
​
error_status
enum<string>

The deployment error status to filter by. Last known error state of the deployment.

  • None: no errors
  • Retrying: an error has been encountered and the agent is retrying to reach the target status
  • Failed: a fatal error has been encountered; the deployment is archived and (if deployed) removed from the device
Available options:
none,
failed,
retrying
​
device_id
string

The deployment device ID to filter by.

Example:

"dvc_123"

​
release_id
string

The deployment release ID to filter by.

Example:

"rls_123"

Response

200 - application/json

Successfully listed the deployments.

​
object
enum<string>
required
Available options:
list
Example:

"list"

​
total_count
integer<int64>
required

The total number of items in the list. By default the total count is not returned. The total count must be expanded (using expand[]=total_count) to get the total number of items in the list.

​
limit
integer
default:10
required

The maximum number of items to return. A limit of 15 with an offset of 0 returns items 1-15.

Required range: 1 <= x <= 100
​
offset
integer
default:0
required

The offset of the items to return. An offset of 10 with a limit of 10 returns items 11-20.

Required range: x >= 0
​
has_more
boolean
required

True if there are more items in the list to return. False if there are no more items to return.

Example:

false

​
data
Deployment · object[]
required
Last modified on March 15, 2026