Create Workbench Setup
curl --request POST \
--url https://api.bland.ai/v1/evals/workbench-setups \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"name": "<string>",
"description": {}
}
'{
"errors": null,
"data": {
"setup": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"org_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"key": "onboarding-quality-check",
"name": "Onboarding Quality Check",
"description": "Evaluates tone, accuracy, and resolution rate across onboarding calls.",
"current_version_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"active_version_id": null,
"metadata": {},
"created_at": "2026-05-27T09:00:00.000Z",
"updated_at": "2026-05-27T09:00:00.000Z",
"deleted_at": null
},
"current_version": {
"id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"org_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"workbench_setup_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"version_number": 1,
"name": "Onboarding Quality Check",
"description": "Evaluates tone, accuracy, and resolution rate across onboarding calls.",
"state": "editable",
"attached_agents": [],
"pass_threshold_pct": null,
"run_mode": "text",
"default_test_config_id": null,
"default_call_ids": [],
"created_from_version_id": null,
"created_by": "9a8b7c6d-5e4f-3210-9876-543210fedcba",
"created_at": "2026-05-27T09:00:00.000Z",
"updated_at": "2026-05-27T09:00:00.000Z"
}
}
}
Workbench Setups
Create Workbench Setup
Create a new workbench setup with an empty draft version.
POST
/
v1
/
evals
/
workbench-setups
Create Workbench Setup
curl --request POST \
--url https://api.bland.ai/v1/evals/workbench-setups \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"name": "<string>",
"description": {}
}
'{
"errors": null,
"data": {
"setup": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"org_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"key": "onboarding-quality-check",
"name": "Onboarding Quality Check",
"description": "Evaluates tone, accuracy, and resolution rate across onboarding calls.",
"current_version_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"active_version_id": null,
"metadata": {},
"created_at": "2026-05-27T09:00:00.000Z",
"updated_at": "2026-05-27T09:00:00.000Z",
"deleted_at": null
},
"current_version": {
"id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"org_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"workbench_setup_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"version_number": 1,
"name": "Onboarding Quality Check",
"description": "Evaluates tone, accuracy, and resolution rate across onboarding calls.",
"state": "editable",
"attached_agents": [],
"pass_threshold_pct": null,
"run_mode": "text",
"default_test_config_id": null,
"default_call_ids": [],
"created_from_version_id": null,
"created_by": "9a8b7c6d-5e4f-3210-9876-543210fedcba",
"created_at": "2026-05-27T09:00:00.000Z",
"updated_at": "2026-05-27T09:00:00.000Z"
}
}
}
Headers
Your API key for authentication.
Body Parameters
Display name for the setup. Between 1 and 200 characters.
Optional description of the setup.
Response
Returns201 on success.
An object containing the new setup and its draft version.
Show setup
Show setup
Unique identifier for the workbench setup.
ID of the organization that owns this setup.
Stable slug key for the setup.
Display name of the setup.
Description of the setup, or
null if not set.ID of the current editable draft version.
ID of the published version, or
null if never published.Key-value metadata. Values are strings.
ISO 8601 timestamp for when the setup was created.
ISO 8601 timestamp for when the setup was last updated.
ISO 8601 timestamp for when the setup was deleted, or
null if not deleted.Show current_version
Show current_version
Unique identifier for this version.
ID of the organization that owns this version.
ID of the parent workbench setup.
Monotonically increasing version number.
Display name of this version.
Description of this version, or
null if not set."editable" for a draft, "archived" for a published snapshot.Eval agents attached to this version. Each item contains
eval_agent_id, eval_agent_version_id, weight (0-100), and target_level_keys (array of strings).Percentage of calls that must pass for a run to be considered passing (0-100), or
null if not set.How calls are evaluated. One of
text, audio, or full.ID of the default test configuration, or
null if not set.Default call IDs to evaluate against. Up to 5000 entries.
ID of the version this was forked from, or
null if it is the first version.Identifier of the user who created this version, or
null.ISO 8601 timestamp for when this version was created.
ISO 8601 timestamp for when this version was last updated.
null on success.{
"errors": null,
"data": {
"setup": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"org_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"key": "onboarding-quality-check",
"name": "Onboarding Quality Check",
"description": "Evaluates tone, accuracy, and resolution rate across onboarding calls.",
"current_version_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"active_version_id": null,
"metadata": {},
"created_at": "2026-05-27T09:00:00.000Z",
"updated_at": "2026-05-27T09:00:00.000Z",
"deleted_at": null
},
"current_version": {
"id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"org_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"workbench_setup_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"version_number": 1,
"name": "Onboarding Quality Check",
"description": "Evaluates tone, accuracy, and resolution rate across onboarding calls.",
"state": "editable",
"attached_agents": [],
"pass_threshold_pct": null,
"run_mode": "text",
"default_test_config_id": null,
"default_call_ids": [],
"created_from_version_id": null,
"created_by": "9a8b7c6d-5e4f-3210-9876-543210fedcba",
"created_at": "2026-05-27T09:00:00.000Z",
"updated_at": "2026-05-27T09:00:00.000Z"
}
}
}
Was this page helpful?
⌘I