---
title: "Get a benchmark suite with its tasks and configurations"
method: GET
path: "/factory/{factory_uid}/benchmarks/{suite_uid}"
tags: ["Factories", "Benchmarks"]
---

# Get a benchmark suite with its tasks and configurations

`GET /factory/{factory_uid}/benchmarks/{suite_uid}`

## Request

- Base URL: `https://app.warp.dev/api/v1`
- URL: `https://app.warp.dev/api/v1/factory/{factory_uid}/benchmarks/{suite_uid}`
- Auth: HTTP bearer

## Path parameters

- `factory_uid` string, required
- `suite_uid` string, required

## Response `200`

Suite details

- BenchmarkSuiteDetail
  - `uid` string, required
  - `factory_uid` string, required
  - `name` string, required
  - `description` string
  - `agent_uid` string, required: UID of the concrete Factory agent every task in this suite dispatches as. Must resolve to a live, available agent linked to this Factory whose agent_type equals factory_agent_type.
  - `factory_agent_type` string, required: Coarse Factory agent type of the selected agent_uid, kept in sync with it at save time.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `creator` BenchmarkSuiteCreator
    - `type` 'user' | 'agent', required
    - `uid` string, required
    - `display_name` string
  - `configurations` BenchmarkConfigurationInput[]: File-authored launch defaults. Omitted on suites without persistent configurations.
    - `display_name` string: Optional display name. Surrounding whitespace is trimmed; empty clears the name.
    - `harness` string
    - `model` string
    - `runner_id` string, nullable: Optional runner UID, constrained to the Factory's existing runner roster. Omitted or empty uses the agent's or environment's default.
    - `harness_auth_secret_name` string, nullable: Optional managed-secret name this configuration's third-party harness authenticates with. Empty or omitted is valid for Oz. For a third-party harness that requires auth, empty or omitted means from the worker environment on a self-hosted host, or a launch violation on Warp-hosted.
    - `agent_configs` BenchmarkAgentConfigInput[]: Optional per-named-Agent overrides keyed by stable Agent UID.
      - `agent_uid` string, uuid, required
      - `agent_name` string
      - `harness` string, required
      - `model` string, required
      - `harness_auth_secret_name` string, nullable
  - `tasks` BenchmarkSuiteTask[]
    - `uid` string, uuid, required: Immutable public task identifier.
    - `title` string, required
    - `prompt` string, required
    - `success_criteria` string, required: Plain-text criteria the built-in Correctness scorer grades each trial against, as the authoritative requirements. The task prompt provides context only.
    - `source_run_id` string, nullable
    - `labels` object
    - `tags` string[]
    - `starting_repo_refs` BenchmarkRepoRef[]
      - `code_forge` string, required
      - `owner` string, required
      - `repo` string, required
      - `ref` string
  - `spawnable_descendant_agent_uids` string[], required: Stable UID-sorted list of live, non-system Factory agents transitively reachable from this suite's selected root under the server's effective delegation policy.

## Other responses

- `401`: Authentication required
- `403`: Factory access is not enabled for the authenticated principal
- `404`: Suite not found

## Changes

- **2026-10-21** `7ee3ba55debc`: 3 info
  - api tag `factory-benchmarks` added
  - api tag `benchmark` removed
  - api tag `factory` removed
- **2026-10-15** `f4630aae17ba`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/warp/apis/oz-agent-api/changes/factory/:factory_uid/benchmarks/:suite_uid/get.md)

---

[API](https://skmtc.dev/warp/apis/oz-agent-api.md) - [All operations](https://skmtc.dev/warp/apis/oz-agent-api/llms.txt) - [OpenAPI document](https://skmtc.dev/warp/apis/oz-agent-api/revisions/4b5d145669be?raw)