Get

Authorizations

X-API-Key

string

header

required

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

Path Parameters

release_id

string

required

The unique identifier of the release.

Example:

"rls_123"

Query Parameters

expand[]

enum<string>[]

The fields to expand in the releases.

Hide child attributes

enum<string>

Available options:

config_schemas

Response

200 - application/json

Successfully retrieved the release.

object

enum<string>

required

Available options:

release

Example:

"release"

string

required

ID of the release.

Example:

"rls_123"

version

string

required

The version of the release.

Example:

"v1.0.0"

created_at

string<date-time>

required

Timestamp of when the release was created.

Example:

"2024-01-01T00:00:00Z"

updated_at

string<date-time>

required

Timestamp of when the release was last updated.

Example:

"2024-01-01T00:00:00Z"

config_schemas

Config Schema · object[] | null

required

Expand the config schemas using 'expand[]=config_schemas' in the query string.

Hide child attributes

object

enum<string>

required

Available options:

config_schema

Example:

"config_schema"

string

required

ID of the config schema.

Example:

"cfg_sch_123"

version

integer

required

Config schema version for the config type.

Example:

2

digest

string

required

Hash of the config schema contents.

Example:

"1234567890"

relative_filepath

string

required

The file path to deploy the config instance relative to /srv/miru/config_instances. v1/motion-control.json would deploy to /srv/miru/config_instances/v1/motion-control.json.

Example:

"/v1/motion-control.json"

created_at

string<date-time>

required

Timestamp of when the config schema was created.

Example:

"2021-01-01T00:00:00Z"

updated_at

string<date-time>

required

Timestamp of when the config schema was last updated.

Example:

"2021-01-01T00:00:00Z"

config_type_id

string

required

ID of the config type.

Example:

"cfg_typ_123"

content

object | null

required

The config schema's JSON Schema definition.

Example:

{
  "title": "Robot Features",
  "type": "object",
  "properties": {
    "enable_autonomy": { "type": "boolean", "default": true },
    "enable_remote_control": { "type": "boolean", "default": true },
    "max_payload_kg": {
      "type": "number",
      "minimum": 0,
      "maximum": 99,
      "default": 10
    },
    "preferred_speed_mode": {
      "type": "string",
      "enum": ["slow", "normal", "fast"],
      "default": "normal"
    },
    "emergency_stop_sensitivity": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "default": 0.8
    },
    "telemetry": {
      "type": "object",
      "properties": {
        "upload_interval_sec": {
          "type": "integer",
          "minimum": 10,
          "maximum": 600,
          "default": 60
        },
        "heartbeat_interval_sec": {
          "type": "integer",
          "minimum": 1,
          "maximum": 60,
          "default": 10
        }
      },
      "required": [
        "upload_interval_sec",
        "heartbeat_interval_sec"
      ]
    }
  },
  "required": [
    "enable_autonomy",
    "enable_remote_control",
    "max_payload_kg",
    "preferred_speed_mode",
    "emergency_stop_sensitivity",
    "telemetry"
  ]
}

config_type

object

required

Expand the config type using 'expand[]=config_type' in the query string.

Hide child attributes

config_type.object

enum<string>

required

Available options:

config_type

Example:

"config_type"

config_type.id

string

required

ID of the config type.

Example:

"cfg_123"

config_type.name

string

required

Name of the config type.

Example:

"My Config Type"

config_type.slug

string

required

An immutable, code-friendly name for the config type.

Example:

"my-config-type"

config_type.created_at

string<date-time>

required

Timestamp of when the config type was created.

Example:

"2021-01-01T00:00:00Z"

config_type.updated_at

string<date-time>

required

Timestamp of when the config type was last updated.

Example:

"2021-01-01T00:00:00Z"

Example:

null

Example:

[]

Server-Side API

SDKs

Endpoints

Webhooks

Authorizations

Path Parameters

Query Parameters

Response