Skip to main content
PATCH
/
v1
/
evals
/
workbench-setups
/
{setup_id}
/
versions
/
{version_id}
Update Workbench Setup Version
curl --request PATCH \
  --url https://api.bland.ai/v1/evals/workbench-setups/{setup_id}/versions/{version_id} \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "name": "<string>",
  "description": {},
  "attached_agents": [
    {}
  ],
  "pass_threshold_pct": {},
  "run_mode": "<string>",
  "default_test_config_id": {},
  "default_call_ids": {}
}
'
{
  "errors": null,
  "data": {
    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "org_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "workbench_setup_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "version_number": 4,
    "name": "Onboarding Quality Check",
    "description": "Updated to include empathy grading.",
    "state": "editable",
    "attached_agents": [
      {
        "eval_agent_id": "e5f6a7b8-c9d0-1234-efab-345678901234",
        "eval_agent_version_id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
        "weight": 40,
        "target_level_keys": ["good", "excellent"]
      },
      {
        "eval_agent_id": "a0b1c2d3-e4f5-6789-abcd-ef0123456789",
        "eval_agent_version_id": "b1c2d3e4-f5a6-7890-bcde-f01234567890",
        "weight": 60,
        "target_level_keys": ["acceptable", "good"]
      }
    ],
    "pass_threshold_pct": 80,
    "run_mode": "full",
    "default_test_config_id": null,
    "default_call_ids": [
      "call_abc123",
      "call_def456",
      "call_ghi789"
    ],
    "created_from_version_id": "d4e5f6a7-b8c9-0123-defa-234567890123",
    "created_by": "9a8b7c6d-5e4f-3210-9876-543210fedcba",
    "created_at": "2026-05-20T14:00:00.000Z",
    "updated_at": "2026-05-27T12:00:00.000Z"
  }
}

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.

Only versions in the editable state can be updated. To make changes to a published (archived) version, fork a new draft from it first using the Create Workbench Setup Version endpoint.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Path Parameters

​
setup_id
string
required
The ID of the workbench setup.
​
version_id
string
required
The ID of the draft version to update.

​
Body Parameters

All fields are optional. Only include fields you want to update.
​
name
string
Updated display name for the version. Between 1 and 200 characters.
​
description
string | null
Updated description, or null to clear it.
​
attached_agents
array
Replaces the full list of attached eval agents. Up to 20 agents. Each item requires:
  • eval_agent_id (string, required) - ID of the eval agent to attach.
  • eval_agent_version_id (string, required) - Version of the eval agent to use.
  • weight (number, required) - Relative weight for this agent in scoring (0-100).
  • target_level_keys (array of strings, required) - One or more target level keys this agent evaluates against.
​
pass_threshold_pct
integer | null
Percentage of calls that must pass for a run to be considered passing. Between 0 and 100, or null to clear.
​
run_mode
string
How calls are evaluated. One of text, audio, or full.
​
default_test_config_id
string | null
ID of the default test configuration to use for runs, or null to clear.
​
default_call_ids
array of strings
Default call IDs to evaluate against when no explicit call list is provided at run time. Replaces the existing list. Up to 5000 entries.

​
Response

​
data
object
The full updated version object.
​
errors
null
null on success.
{
  "errors": null,
  "data": {
    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "org_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "workbench_setup_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "version_number": 4,
    "name": "Onboarding Quality Check",
    "description": "Updated to include empathy grading.",
    "state": "editable",
    "attached_agents": [
      {
        "eval_agent_id": "e5f6a7b8-c9d0-1234-efab-345678901234",
        "eval_agent_version_id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
        "weight": 40,
        "target_level_keys": ["good", "excellent"]
      },
      {
        "eval_agent_id": "a0b1c2d3-e4f5-6789-abcd-ef0123456789",
        "eval_agent_version_id": "b1c2d3e4-f5a6-7890-bcde-f01234567890",
        "weight": 60,
        "target_level_keys": ["acceptable", "good"]
      }
    ],
    "pass_threshold_pct": 80,
    "run_mode": "full",
    "default_test_config_id": null,
    "default_call_ids": [
      "call_abc123",
      "call_def456",
      "call_ghi789"
    ],
    "created_from_version_id": "d4e5f6a7-b8c9-0123-defa-234567890123",
    "created_by": "9a8b7c6d-5e4f-3210-9876-543210fedcba",
    "created_at": "2026-05-20T14:00:00.000Z",
    "updated_at": "2026-05-27T12:00:00.000Z"
  }
}