> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Workbench Setup Versions

> List all versions of a workbench setup.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**setup\_id** `string` *required*

The ID of the workbench setup whose versions you want to list.

### Query Parameters

**limit** `integer` (default: 25)

Number of results to return. Between 1 and 100.

**starting\_after** `string`

Cursor: return results after this object ID.

**ending\_before** `string`

Cursor: return results before this object ID. Cannot be combined with `starting_after`.

### Response

**object** `string`

Always `"list"`.

**data** `array of objects`

The list of versions. Each item contains the fields below.

**data\[].id** `string`

Unique identifier for this version.

**data\[].workbench\_setup\_id** `string`

ID of the parent workbench setup.

**data\[].version\_number** `integer`

Monotonically increasing version number.

**data\[].name** `string`

Display name of this version.

**data\[].state** `string`

`"editable"` for a draft, `"archived"` for a published snapshot.

**data\[].attached\_agent\_count** `integer`

Number of eval agents attached to this version.

**data\[].created\_by** `string | null`

Identifier of the user who created this version, or `null`.

**data\[].created\_at** `string`

ISO 8601 timestamp for when this version was created.

**data\[].latest\_run** `object | null`

Summary of the most recent run against this version, or `null` if none exist.

* `id` - Run ID.
* `status` - Status of the run.
* `created_at` - ISO 8601 timestamp.

**has\_more** `boolean`

Whether more results exist beyond this page.

**next\_cursor** `string | null`

Cursor to pass as `starting_after` to fetch the next page, or `null` if there are no more results.

```json Response theme={null}
{
  "errors": null,
  "data": {
    "object": "list",
    "data": [
      {
        "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "workbench_setup_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "version_number": 4,
        "name": "Onboarding Quality Check",
        "state": "editable",
        "attached_agent_count": 4,
        "created_by": "9a8b7c6d-5e4f-3210-9876-543210fedcba",
        "created_at": "2026-05-20T14:00:00.000Z",
        "latest_run": null
      },
      {
        "id": "d4e5f6a7-b8c9-0123-defa-234567890123",
        "workbench_setup_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "version_number": 3,
        "name": "Onboarding Quality Check",
        "state": "archived",
        "attached_agent_count": 4,
        "created_by": "9a8b7c6d-5e4f-3210-9876-543210fedcba",
        "created_at": "2026-04-10T09:00:00.000Z",
        "latest_run": {
          "id": "e5f6a7b8-c9d0-1234-efab-345678901234",
          "status": "completed",
          "created_at": "2026-05-15T16:00:00.000Z"
        }
      }
    ],
    "has_more": false,
    "next_cursor": null
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.