---
title: "Configuration"
method: GET
path: "/api/v1/swarms/runs/{run_id}/configuration"
---

# Configuration

`GET /api/v1/swarms/runs/{run_id}/configuration`

## Request

- Base URL: `https://api.usesynth.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.usesynth.ai/api/v1/swarms/runs/{run_id}/configuration`
- Auth: none declared

## Path parameters

- `run_id` string, required

## Response `200`

Successful Response

- ResolvedConfiguration
  - `metadata` ResponseMetadata, required
    - `contract` 'index.v1' | 'swarms.v1' | 'core.v1', required
    - `request_id` string, required
    - `operation_id` string, nullable, required
    - `observed_at` string, date-time, required
    - `server_timing` TimingSpan[]
      - `name` 'request' | 'queue' | 'first_useful' | 'active' | 'wall' | 'settlement', required
      - `duration_ms` number, nullable, required
      - `source` 'server' | 'worker' | 'unknown', required
      - `clock` 'monotonic' | 'utc' | 'unknown', required
      - `uncertainty_ms` number, nullable, required
    - `client_timing` ClientTiming
      - `total_ms` number, required
      - `first_byte_ms` number, required
      - `attempts` integer, required
      - `source` 'sdk_monotonic'
  - `run_id` string, nullable, required
  - `project_id` string, required
  - `configuration_id` string, required
  - `digest_sha256` string, required
  - `profile_id` string, required
  - `runtime_image_digest` string, required
  - `limits` Limits, required
    - `maximum_charge` Money, required
      - `coefficient` integer, required
      - `scale` integer, required
      - `currency` 'USD'
    - `wall_time_seconds` integer, required
    - `maximum_tasks` integer, required
    - `maximum_parallel_tasks` integer, required
  - `inputs` Inputs, required
    - `files` FileRef[]
      - `file_id` string, required
      - `revision_id` string, required
      - `project_id` string, required
      - `digest_sha256` string, required
    - `artifacts` PackagesCustomerApiTypesRefsExactReference[]
      - `authority` string, required
      - `kind` string, required
      - `record_id` string, required
      - `revision` string, required
      - `digest_sha256` string, required
    - `derived_from` PackagesCustomerApiTypesRefsExactReference
      - `authority` string, required
      - `kind` string, required
      - `record_id` string, required
      - `revision` string, required
      - `digest_sha256` string, required
  - `providers` ResolvedProviders, required: Read-only backend routing; changing it requires an admitted override.
    - `default` string, required
  - `models` ResolvedModels, required: Read-only backend selection; not a caller override allowlist.
    - `default` string, required
  - `repo` RepoSelector: Launch on a project repository at an exact base commit (SYN-4885). ``base`` is the git-server commit Ref (core.v1: authority ``git``, kind ``commit``, record_id = ``repo_id``, revision = full SHA-1, digest = git-server commit manifest digest). The backend verifies the repository belongs to the launch project and the commit exists with that digest, then freezes it into the run configuration and seeds the workspace from it.
    - `repo_id` string, required
    - `base` PackagesCustomerApiTypesRefsExactReference, required
      - `authority` string, required
      - `kind` string, required
      - `record_id` string, required
      - `revision` string, required
      - `digest_sha256` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/usesynth/apis/synth-api.md) - [All operations](https://skmtc.dev/usesynth/apis/synth-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usesynth/apis/synth-api/revisions/4d199548e98a?raw)