Skip to main content
PATCH
Update Workbench Setup Version
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

string
required
Your API key for authentication.

Path Parameters

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

Body Parameters

All fields are optional. Only include fields you want to update.
string
Updated display name for the version. Between 1 and 200 characters.
string | null
Updated description, or null to clear it.
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.
integer | null
Percentage of calls that must pass for a run to be considered passing. Between 0 and 100, or null to clear.
string
How calls are evaluated. One of text, audio, or full.
string | null
ID of the default test configuration to use for runs, or null to clear.
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

object
The full updated version object.
null
null on success.