---
title: "Get application configuration"
method: GET
path: "/app-config"
tags: ["config"]
---

# Get application configuration

`GET /app-config`

## Request

- The document declares no server URL.
- Auth: none declared

Returns app config including transcripts and scans directories.

## Response `200`

Successful Response

- AppConfig: Application configuration returned by GET /config. `trust_content` is the viewer-wide cap: the lowest of the `scout view` option (or `SCOUT_VIEW_TRUST_CONTENT`) and the project's setting.
  - `filter` union, required
    - string
    - string[]
  - `generate_config` GenerateConfigOutput: Model generation options.
    - `adaptive_connections` union
      - boolean
      - integer
      - AdaptiveConcurrency: Bounds and tuning for an adaptive concurrency controller. Basic fields (`min`, `start`, `max`) bound the range the controller will scale within. Advanced fields (`cooldown_seconds`, `decrease_factor`, `scale_up_percent`) tune the response curve and have sensible defaults for typical evaluation workloads — see the parallelism docs for guidance. Accepts a string shorthand ("min-max" or "min-start-max") for use in CLI flags and config files; advanced fields are Python-only.
        - `cooldown_seconds` number, required
        - `decrease_factor` number, required
        - `max` integer, required
        - `min` integer, required
        - `scale_up_percent` number, required
        - `start` integer, required
    - `attempt_timeout` integer, nullable
    - `batch` union
      - boolean
      - integer
      - BatchConfig: Batch processing configuration.
        - `max_batches` integer, nullable
        - `max_consecutive_check_failures` integer, nullable
        - `max_size` integer, nullable
        - `send_delay` number, nullable
        - `size` integer, nullable
        - `tick` number, nullable
    - `best_of` integer, nullable
    - `cache` union
      - boolean
      - CachePolicy: Caching options for model generation.
        - `expiry` string, nullable
        - `per_epoch` boolean, required
        - `scopes` object, required
    - `cache_prompt` union
      - 'auto'
      - boolean
    - `effort` 'low' | 'medium' | 'high' | 'xhigh' | 'max', nullable
    - `extra_body` object, nullable
    - `extra_headers` object, nullable
    - `fail_on_refusal` boolean, nullable
    - `fallback_models` string[], nullable
    - `frequency_penalty` number, nullable
    - `internal_tools` boolean, nullable
    - `logit_bias` object, nullable
    - `logprobs` boolean, nullable
    - `max_connections` integer, nullable
    - `max_retries` integer, nullable
    - `max_tokens` integer, nullable
    - `max_tool_output` integer, nullable
    - `modalities` union[], nullable
      - union
        - 'image'
        - ImageOutput: Image output configuration. Use the `options` field to pass provider-specific options directly to the underlying API (e.g. OpenAI image_generation tool parameters).
          - `options` object, nullable
    - `num_choices` integer, nullable
    - `parallel_tool_calls` boolean, nullable
    - `presence_penalty` number, nullable
    - `prompt_logprobs` integer, nullable
    - `reasoning_effort` 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max', nullable
    - `reasoning_history` 'none' | 'all' | 'last' | 'auto', nullable
    - `reasoning_mode` 'standard' | 'pro', nullable
    - `reasoning_summary` 'none' | 'concise' | 'detailed' | 'auto', nullable
    - `reasoning_tokens` integer, nullable
    - `response_schema` ResponseSchemaOutput: Schema for model response when using Structured Output.
      - `description` string, nullable
      - `json_schema` JSONSchemaOutput, required: JSON Schema for type.
        - `additionalProperties` union
          - JSONSchemaOutput (recursive)
          - boolean
        - `anyOf` JSONSchemaOutput[], nullable
        - `default` unknown, required
        - `description` string, nullable
        - `enum` unknown[], nullable
          - unknown
        - `examples` unknown[], nullable
          - unknown
        - `format` string, nullable
        - `items` JSONSchemaOutput (recursive)
        - `maxLength` integer, nullable
        - `maximum` union
          - integer
          - number
        - `minLength` integer, nullable
        - `minimum` union
          - integer
          - number
        - `pattern` string, nullable
        - `properties` object, nullable
        - `required` string[], nullable
        - `type` union
          - 'string' | 'integer' | 'number' | 'boolean' | 'array' | 'object' | 'null'
          - string[]
      - `name` string, required
      - `strict` boolean, nullable
    - `seed` integer, nullable
    - `stop_seqs` string[], nullable
    - `stream_idle_timeout` integer, nullable
    - `system_message` string, nullable
    - `temperature` number, nullable
    - `timeout` integer, nullable
    - `top_k` integer, nullable
    - `top_logprobs` integer, nullable
    - `top_p` number, nullable
    - `verbosity` 'low' | 'medium' | 'high', nullable
  - `home_dir` string, required
  - `limit` integer, nullable
  - `log_level` 'debug' | 'http' | 'sandbox' | 'info' | 'warning' | 'error' | 'critical' | 'notset', nullable
  - `max_processes` integer, nullable
  - `max_transcripts` integer, nullable
  - `metadata` object, nullable
  - `model` string, nullable
  - `model_args` union
    - object
    - string
  - `model_base_url` string, nullable
  - `model_roles` object, nullable
  - `name` string, nullable
  - `project_dir` string, required
  - `results` string, nullable
  - `results_buffer` integer, nullable
  - `scanners` union
    - ScannerSpec[]
      - `file` string, nullable
      - `name` string, required
      - `package_version` string, nullable
      - `params` object, required
      - `version` integer, required
    - object
  - `scans` AppDir, required: Directory with source tracking.
    - `dir` string, required
    - `source` 'project' | 'cli', required
  - `shuffle` union
    - boolean
    - integer
  - `tags` string[], nullable
  - `transcripts` AppDir: Directory with source tracking.
    - `dir` string, required
    - `source` 'project' | 'cli', required
  - `trust_content` boolean, nullable
  - `validation` object, nullable
  - `worklist` Worklist[], nullable
    - `scanner` string, required
    - `transcripts` string[], required

## Changes

- **2026-10-09** `624af02c270c`: 1 info
  - added the optional property `trust_content` to the response with the `200` status
- **2026-09-15** `211de6950b48`: 2 info
  - added the optional property `generate_config/anyOf[subschema #1: GenerateConfig]/fail_on_refusal` to the response with the `200` status
  - added the optional property `model_roles/anyOf[subschema #1]/additionalProperties/anyOf[subschema #1: ModelConfig]/config/fail_on_refusal` to the response with the `200` status
- **2026-09-03** `6165ea7e87bd`: 2 info
  - added `#/components/schemas/ValidationSet` to the `validation/anyOf[subschema #1]/additionalProperties/` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/ValidationSet-Output` from the `validation/anyOf[subschema #1]/additionalProperties/` response property `anyOf` list for the response status `200`
- **2026-09-02** `d355ae9ed598`: 2 info
  - added the optional property `generate_config/anyOf[subschema #1: GenerateConfig]/stream_idle_timeout` to the response with the `200` status
  - added the optional property `model_roles/anyOf[subschema #1]/additionalProperties/anyOf[subschema #1: ModelConfig]/config/stream_idle_timeout` to the response with the `200` status
- **2026-08-04** `09cc54e3f328`: 1 info
  - added the optional property `results_buffer` to the response with the `200` status

[Operation history](https://skmtc.dev/meridianlabs-ai/apis/inspect-scout-viewer-api/changes/app-config/get.md)

---

[API](https://skmtc.dev/meridianlabs-ai/apis/inspect-scout-viewer-api.md) - [All operations](https://skmtc.dev/meridianlabs-ai/apis/inspect-scout-viewer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/meridianlabs-ai/apis/inspect-scout-viewer-api/revisions/b799e9a81653?raw)