---
title: "Retrieve Eval Configuration"
method: GET
path: "/v1/api-performance/evals/{eval_id}"
tags: ["Eval Configuration"]
---

# Retrieve Eval Configuration

`GET /v1/api-performance/evals/{eval_id}`

## Request

- Base URL: `https://api.lightsage.com`
- URL: `https://api.lightsage.com/v1/api-performance/evals/{eval_id}`
- Auth: API key in header `X-Lightsage-Api-Key`

Returns one eval configuration, including its prompt, graders, source, and runtime settings.

## Path parameters

- `eval_id` string, required

## Response `200`

Successful Response

- PublicEvalDefinition
  - `id` string, required
  - `operation_id` string, required: For a user-created eval, equals the eval ID when `source_id` is null.
  - `source_id` string, nullable: Null for a user-created eval configuration.
  - `source` PublicApiPerformanceSourceRef
    - `id` string, required
    - `type` string, nullable: The source type: `rest_api`, `python_sdk`, `node_sdk`, or `cli`.
    - `label` string, nullable
  - `eval_type` string, required
  - `prompt` string, nullable
  - `custom_prompt` string, nullable: Overrides `prompt` when set.
  - `expected_behavior` string, nullable: Deprecated compatibility view of the primary judge criterion. Use `graders` for the canonical configuration.
  - `graders` PublicGraderDefinition[]: Canonical grader definitions used to score the eval.
    - `name` string, required
    - `type` string, required
    - `needle` string, nullable
    - `needles` string[], nullable
    - `pattern` string, nullable
    - `case_sensitive` boolean
    - `criteria` string, nullable
    - `weight` number
    - `blocking` boolean
  - `starting_project_id` string, nullable
  - `docs_mode` 'default' | 'include' | 'exclude': `include` adds the organization's docs to the agent's context; `exclude` withholds them.
  - `include_env_vars` boolean: Names only, never values.
  - `env_profile_ids` string[]
  - `model_ids` string[]: Empty means the config-level models are used.
  - `compare_skills` boolean: Whether to run an additional comparison with skill context enabled.
  - `skills_mode` 'none' | 'all' | 'selected': `selected` uses `skill_ids`; `all` uses every skill; `none` supplies no skill context.
  - `skills_enabled` boolean
  - `skill_ids` string[]
  - `mcp_enabled` boolean
  - `search_grounding` 'disabled' | 'enabled' | 'default': Requested web-retrieval behavior for an eval run.
  - `grounding_enabled` boolean: Whether native web search and URL retrieval tools are available to the agent. When false, configured brand docs are also withheld.
  - `run_context` object
  - `enabled` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/usesapient/apis/sapient-public-api.md) - [All operations](https://skmtc.dev/usesapient/apis/sapient-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usesapient/apis/sapient-public-api/revisions/14890dfe867e?raw)