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

# Publish Workbench Setup

> Publish the setup's current draft as a new active version.

> [!NOTE]
>
> A setup must have at least one attached agent before it can be published. Each attached agent must also have at least one target level key assigned.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

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

The ID of the workbench setup to publish.

### Response

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

ID of the workbench setup that was published.

**data.current\_version\_id** `string`

ID of the new editable draft version created after publishing.

**data.active\_version\_id** `string`

ID of the newly published (archived) version. This is now the active version.

**data.published\_version** `object`

Summary of the version that was published.

**published\_version fields**

**id** `string`

Unique identifier for the published version.

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

ID of the parent workbench setup.

**version\_number** `integer`

Version number of the published snapshot.

**name** `string`

Display name of the version.

**state** `string`

Always `"archived"` for a published version.

**attached\_agent\_count** `integer`

Number of eval agents in this version.

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

**latest\_run** `object | null`

The most recent run against this version, or `null` if none exist.

**errors** `null`

`null` on success.

```json Response theme={null}
{
  "errors": null,
  "data": {
    "workbench_setup_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "current_version_id": "e5f6a7b8-c9d0-1234-efab-345678901234",
    "active_version_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "published_version": {
      "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
      "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-05-20T14:00:00.000Z",
      "latest_run": null
    }
  }
}
```


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