---
title: "List benchmark suites"
method: GET
path: "/factory/{factory_uid}/benchmarks"
tags: ["Factories", "Benchmarks"]
---

# List benchmark suites

`GET /factory/{factory_uid}/benchmarks`

## Request

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

## Path parameters

- `factory_uid` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

List of suites

- ListBenchmarkSuitesResponse
  - `data` BenchmarkSuite[], required
    - `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
  - `page_info` BenchmarkPageInfo, required
    - `has_next_page` boolean, required: true when another complete list page exists.
    - `next_cursor` string: opaque scoped keyset cursor, present only when `has_next_page=true`, never null.

## Other responses

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

## 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/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)