---
title: "Get"
method: GET
path: "/config_instances/{config_instance_id}"
tags: ["Config Instances"]
---

# Get

`GET /config_instances/{config_instance_id}`

Retrieve a config instance by ID.

## Path parameters

- `config_instance_id` string, required

## Query parameters

- `expand` ConfigInstanceExpansion[]

## Response `200`

Successfully retrieved the config instance.

- ConfigInstance
  - `object` 'config_instance', required — The object type, which is always `config_instance`.
  - `id` string, required — ID of the config instance.
  - `config_type_name` string, required — The name of the config type.
  - `filepath` string, required — The absolute file system path where this config instance is written.
  - `created_at` string, date-time, required — The timestamp of when the config instance was created.
  - `config_schema_id` string, required — ID of the config schema which the config instance must adhere to.
  - `config_type_id` string, required — ID of the config type which the config instance (and its schema) is a part of.
  - `config_schema` ConfigSchema
    - `object` 'config_schema', required — The object type, which is always `config_schema`.
    - `id` string, required — ID of the config schema.
    - `digest` string, required — The digest of the config schema.
    - `config_type_name` string, required — The name of the config type.
    - `instance_filepath` string, required — The absolute file system path where config instances for this schema are written.
    - `created_at` string, date-time, required — Timestamp of when the config schema was created.
    - `updated_at` string, date-time, required — Timestamp of when the config schema was last updated.
    - `config_type_id` string, required — ID of the config type.
    - `language` 'jsonschema' | 'cue', required
    - `format` 'json' | 'yaml' | 'cue', required
    - `documents` SchemaDocument[]
      - `id` string, required — The unique identifier for this document.
      - `name` string, required — The document filename.
      - `data` string, required — The raw document content.
    - `config_type` ConfigType
      - `object` 'config_type', required — The object type, which is always `config_type`.
      - `id` string, required — ID of the config type.
      - `name` string, required — Name of the config type.
      - `slug` string, required — An immutable, code-friendly name for the config type.
      - `created_at` string, date-time, required — Timestamp of when the config type was created.
      - `updated_at` string, date-time, required — Timestamp of when the config type was last updated.
  - `config_type` ConfigType
    - `object` 'config_type', required — The object type, which is always `config_type`.
    - `id` string, required — ID of the config type.
    - `name` string, required — Name of the config type.
    - `slug` string, required — An immutable, code-friendly name for the config type.
    - `created_at` string, date-time, required — Timestamp of when the config type was created.
    - `updated_at` string, date-time, required — Timestamp of when the config type was last updated.
  - `content` InstanceContent
    - `format` 'json' | 'yaml' | 'jsonc', required
    - `data` string, required — The configuration values associated with the config instance.

## Changes

- **2026-05-06** `152ff386a522` — 2 warning
  - added the new `jsonc` enum value to the `allOf[subschema #2]/content/allOf[subschema #1: Instance Content]/format` response property for the response status `200`
  - added the new `yaml` enum value to the `allOf[subschema #2]/content/allOf[subschema #1: Instance Content]/format` response property for the response status `200`
- **2026-03-06** `365853b9c33d` — 4 info
  - added `#/components/schemas/ConfigType` to the `allOf[subschema #2]/config_schema/allOf[subschema #1: Config Schema]/allOf[subschema #2]/config_type` response property `allOf` list for the response status `200`
  - added `#/components/schemas/ConfigType` to the `allOf[subschema #2]/config_type` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/BaseConfigType` from the `allOf[subschema #2]/config_schema/allOf[subschema #1: Config Schema]/allOf[subschema #2]/config_type` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/BaseConfigType` from the `allOf[subschema #2]/config_type` response property `allOf` list for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/mirurobotics/apis/miru-platform-api/changes/config_instances/:config_instance_id/get.md)

---

[API](https://skmtc.dev/mirurobotics/apis/miru-platform-api.md) · [All operations](https://skmtc.dev/mirurobotics/apis/miru-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mirurobotics/miru-platform-api/revisions/3ca381fa7ccd/schema)