> ## 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.

# Create Workbench Setup Version

> Fork a new editable draft version 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 to fork a new version from.

### Body Parameters

All fields are optional.

**name** `string`

Display name for the new version. Between 1 and 200 characters. Defaults to the source version's name.

**description** `string | null`

Optional description for the new version.

**from\_version\_id** `string`

ID of the version to fork from. Defaults to the current draft if not provided.

### Response

Returns `201` on success.

**data** `object`

The full newly created version object.

**version fields**

**id** `string`

Unique identifier for this version.

**org\_id** `string`

ID of the organization that owns this version.

**workbench\_setup\_id** `string`

ID of the parent workbench setup.

**version\_number** `integer`

Monotonically increasing version number.

**name** `string`

Display name of this version.

**description** `string | null`

Description of this version, or `null` if not set.

**state** `string`

Always `"editable"` for a newly created version.

**attached\_agents** `array`

Eval agents inherited from the source version. Each item contains `eval_agent_id`, `eval_agent_version_id`, `weight` (0-100), and `target_level_keys` (array of strings).

**pass\_threshold\_pct** `integer | null`

Inherited pass threshold percentage (0-100), or `null` if not set.

**run\_mode** `string`

Inherited run mode. One of `text`, `audio`, or `full`.

**default\_test\_config\_id** `string | null`

Inherited default test configuration ID, or `null` if not set.

**default\_call\_ids** `array of strings`

Inherited default call IDs. Up to 5000 entries.

**created\_from\_version\_id** `string | null`

ID of the version this was forked from.

**created\_by** `string | null`

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

**created\_at** `string`

ISO 8601 timestamp for when this version was created.

**updated\_at** `string`

ISO 8601 timestamp for when this version was last updated.

**errors** `null`

`null` on success.

```json Response theme={null}
{
  "errors": null,
  "data": {
    "id": "f7a8b9c0-d1e2-3456-abcd-567890123456",
    "org_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "workbench_setup_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "version_number": 5,
    "name": "Onboarding Quality Check",
    "description": null,
    "state": "editable",
    "attached_agents": [
      {
        "eval_agent_id": "e5f6a7b8-c9d0-1234-efab-345678901234",
        "eval_agent_version_id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
        "weight": 50,
        "target_level_keys": ["good", "excellent"]
      }
    ],
    "pass_threshold_pct": 80,
    "run_mode": "audio",
    "default_test_config_id": null,
    "default_call_ids": [],
    "created_from_version_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "created_by": "9a8b7c6d-5e4f-3210-9876-543210fedcba",
    "created_at": "2026-05-27T10:00:00.000Z",
    "updated_at": "2026-05-27T10:00:00.000Z"
  }
}
```


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