> ## Documentation Index > Fetch the complete documentation index at: https://docs.mirurobotics.com/llms.txt > Use this file to discover all available pages before exploring further. # Get > Retrieve a release by ID. This API version has reached end of life. See [supported versions](/developers/platform-api/versioning#supported-versions). | Scope | Required | | --------------- | -------- | | `releases:read` | Yes | ## OpenAPI ````yaml /references/platform-api/2025-10-21.yaml get /releases/{release_id} openapi: 3.0.3 info: title: Miru API version: 2025-10-21.zion license: name: MIT url: https://opensource.org/licenses/MIT servers: - url: https://api.mirurobotics.com/beta description: Miru API security: - ApiKeyAuth: [] paths: /releases/{release_id}: get: tags: - Releases summary: Get description: Retrieve a release by ID. operationId: getRelease parameters: - $ref: '#/components/parameters/parameters-release_id' - $ref: '#/components/parameters/components-parameters-expand' responses: '200': description: Successfully retrieved the release. content: application/json: schema: $ref: '#/components/schemas/Release' x-codeSamples: - lang: Python source: |- from miru_server_sdk import Miru client = Miru( api_key="My API Key", ) release = client.releases.retrieve( release_id="rls_123", ) print(release.id) components: parameters: parameters-release_id: name: release_id in: path required: true description: The unique identifier of the release. schema: type: string example: rls_123 components-parameters-expand: name: expand[] in: query required: false schema: type: array items: $ref: '#/components/schemas/ExpandRelease' description: The fields to expand in the releases. schemas: Release: title: Release allOf: - $ref: '#/components/schemas/BaseRelease' - type: object required: - config_schemas properties: config_schemas: type: array items: $ref: '#/components/schemas/ConfigSchema' nullable: true description: >- Expand the config schemas using 'expand[]=config_schemas' in the query string. example: [] ExpandRelease: type: string enum: - config_schemas x-enum-varnames: - RELEASE_EXPAND_CONFIG_SCHEMAS BaseRelease: title: Base Release type: object required: - object - id - version - created_at - updated_at properties: object: type: string enum: - release example: release id: type: string example: rls_123 description: ID of the release. version: type: string example: v1.0.0 description: The version of the release. created_at: type: string format: date-time example: '2024-01-01T00:00:00Z' description: Timestamp of when the release was created. updated_at: type: string format: date-time example: '2024-01-01T00:00:00Z' description: Timestamp of when the release was last updated. ConfigSchema: title: Config Schema allOf: - $ref: '#/components/schemas/BaseConfigSchema' - type: object required: - config_type properties: config_type: allOf: - $ref: '#/components/schemas/ConfigType' nullable: true description: >- Expand the config type using 'expand[]=config_type' in the query string. example: null BaseConfigSchema: title: Base Config Schema type: object required: - object - id - version - digest - relative_filepath - created_at - updated_at - config_type_id - content properties: object: type: string enum: - config_schema example: config_schema id: type: string example: cfg_sch_123 description: ID of the config schema. version: type: integer example: 2 description: Config schema version for the config type. digest: type: string example: '1234567890' description: Hash of the config schema contents. relative_filepath: type: string example: /v1/motion-control.json description: >- 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`. created_at: type: string format: date-time example: '2021-01-01T00:00:00Z' description: Timestamp of when the config schema was created. updated_at: type: string format: date-time example: '2021-01-01T00:00:00Z' description: Timestamp of when the config schema was last updated. config_type_id: type: string example: cfg_typ_123 description: ID of the config type. content: type: object description: 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 nullable: true ConfigType: title: Config Type allOf: - $ref: '#/components/schemas/BaseConfigType' BaseConfigType: title: Config Type type: object required: - object - id - name - slug - created_at - updated_at properties: object: type: string enum: - config_type example: config_type id: type: string example: cfg_123 description: ID of the config type. name: type: string example: My Config Type description: Name of the config type. slug: type: string example: my-config-type description: An immutable, code-friendly name for the config type. created_at: type: string format: date-time example: '2021-01-01T00:00:00Z' description: Timestamp of when the config type was created. updated_at: type: string format: date-time example: '2021-01-01T00:00:00Z' description: Timestamp of when the config type was last updated. securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: >- The API key to use for authentication. Retrieve your API key from the [Miru dashboard](https://app.mirurobotics.com/settings/api-keys). ````