> ## 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 its ID.



## OpenAPI

````yaml /references/device-api/v0.2.0.yaml get /releases/{release_id}
openapi: 3.0.3
info:
  title: Miru Agent API
  description: >-
    The API between the Miru Agent and any external client living on the same
    device as the Miru Agent
  version: v0.2
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  x-release-version: v0.2.0
  x-git-commit:
    sha: 5e98bcf13136459371f57ae422d353a1e7491b14
    url: >-
      https://github.com/mirurobotics/openapi/commit/5e98bcf13136459371f57ae422d353a1e7491b14
    message: 'chore: bump device api version'
    author: Benjamin Smidt
    branch: HEAD
    dirty: false
  x-build:
    built_at: '2026-03-10T03:12:13.875623+00:00'
servers:
  - url: http://localhost/v0.2
    description: localhost
security: []
paths:
  /releases/{release_id}:
    get:
      tags:
        - Releases
      summary: Get
      description: Retrieve a release by its ID.
      operationId: getRelease
      parameters:
        - $ref: '#/components/parameters/release_id'
      responses:
        '200':
          description: Successfully retrieved the release.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Release'
      x-codeSamples:
        - lang: curl
          source: |-
            curl --unix-socket /run/miru/miru.sock \
              --request GET \
              --url http://localhost/v0.2/releases/{release_id}
        - lang: Python
          source: |-
            from miru_device_sdk import Miru

            client = Miru()
            release = client.releases.retrieve(
                "rls_123",
            )
            print(release.id)
components:
  parameters:
    release_id:
      name: release_id
      in: path
      required: true
      description: The unique identifier of the release.
      schema:
        type: string
        example: rls_123
  schemas:
    Release:
      title: Release
      type: object
      required:
        - object
        - id
        - version
        - git_commit_id
        - created_at
      properties:
        object:
          type: string
          enum:
            - release
          example: release
          x-stainless-const: true
          description: The object type, which is always `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.
        git_commit_id:
          type: string
          nullable: true
          example: git_commit_123
          description: The ID of the git commit associated with this release.
        created_at:
          type: string
          format: date-time
          example: '2024-01-01T00:00:00Z'
          description: Timestamp of when the release was created.
      example:
        object: release
        id: rls_123
        version: v1.0.0
        git_commit_id: git_commit_123
        created_at: '2024-01-01T00:00:00Z'

````