VocalDocscontracts 1.65.0

Contracts 1.55.0

First served on the Phase 0 host by deploy #61 (2026-10-22).

The public document of 1.55.0 lists 183 operations, 38 of them added in this release and still in 1.65.0.

Operations added

OperationSummaryScopeReleased inPhase 0 host
GET /v1/agents/{agent_id}/experimentsList an Agent's experimentsagents:read1.55.0served
POST /v1/agents/{agent_id}/experimentsCreate an experiment on an Agentagents:write1.55.0served
GET /v1/agents/{agent_id}/experiments/{experiment_id}Read an experimentagents:read1.55.0served
POST /v1/agents/{agent_id}/experiments/{experiment_id}/promotePromote a candidate of an experimentagents:write1.55.0served
GET /v1/agents/{agent_id}/experiments/{experiment_id}/resultsRead an experiment's resultsagents:read1.55.0served
POST /v1/agents/{agent_id}/experiments/{experiment_id}/startStart an experimentagents:write1.55.0served
POST /v1/agents/{agent_id}/experiments/{experiment_id}/stopStop an experimentagents:write1.55.0served
POST /v1/agents/{agent_id}/versions/{version}/renderDry-run the composed request of an Agent versionprompts:read1.55.0served
POST /v1/agents/{agent_id}/versions/{version}/testsRun conversation tests against an Agent versionprompts:write1.55.0served
GET /v1/agents/{agent_id}/versions/{version}/tests/{run_id}Read a conversation test runprompts:read1.55.0served
GET /v1/prompt-basesList the platform basesprompts:read1.55.0served
GET /v1/prompt-bases/{version}Read a platform baseprompts:read1.55.0served
GET /v1/prompt-eval-suitesList evaluation suitesprompts:read1.55.0served
POST /v1/prompt-eval-suitesCreate an evaluation suiteprompts:write1.55.0served
GET /v1/prompt-eval-suites/{prompt_eval_suite_id}Read an evaluation suiteprompts:read1.55.0served
PATCH /v1/prompt-eval-suites/{prompt_eval_suite_id}Update an evaluation suiteprompts:write1.55.0served
DELETE /v1/prompt-eval-suites/{prompt_eval_suite_id}Archive an evaluation suiteprompts:write1.55.0served
POST /v1/prompt-eval-suites/{prompt_eval_suite_id}/runsRun an evaluation suiteprompts:write1.55.0served
GET /v1/prompt-eval-suites/{prompt_eval_suite_id}/runs/{run_id}Read an evaluation runprompts:read1.55.0served
GET /v1/prompt-eval-suites/{prompt_eval_suite_id}/runs/{run_id}/verdictsList a run's verdictsprompts:read1.55.0served
GET /v1/prompt-eval-suites/{prompt_eval_suite_id}/scenariosList a suite's scenariosprompts:read1.55.0served
POST /v1/prompt-eval-suites/{prompt_eval_suite_id}/scenariosAdd a scenario to an evaluation suiteprompts:write1.55.0served
GET /v1/prompt-eval-suites/{prompt_eval_suite_id}/scenarios/{scenario_id}Read a scenarioprompts:read1.55.0served
PATCH /v1/prompt-eval-suites/{prompt_eval_suite_id}/scenarios/{scenario_id}Update a scenarioprompts:write1.55.0served
DELETE /v1/prompt-eval-suites/{prompt_eval_suite_id}/scenarios/{scenario_id}Delete a scenarioprompts:write1.55.0served
GET /v1/prompt-libraryList the template libraryprompts:read1.55.0served
GET /v1/prompt-library/{slug}Read a library templateprompts:read1.55.0served
GET /v1/prompt-templatesList Prompt templatesprompts:read1.55.0served
POST /v1/prompt-templatesCreate a Prompt templateprompts:write1.55.0served
GET /v1/prompt-templates/{prompt_template_id}Read a Prompt templateprompts:read1.55.0served
PATCH /v1/prompt-templates/{prompt_template_id}Update the Prompt template draftprompts:write1.55.0served
DELETE /v1/prompt-templates/{prompt_template_id}Archive a Prompt templateprompts:write1.55.0served
GET /v1/prompt-templates/{prompt_template_id}/diffCompare two versions of a Prompt template, or a version and the draftprompts:read1.55.0served
POST /v1/prompt-templates/{prompt_template_id}/renderDry-run render a Prompt templateprompts:read1.55.0served
GET /v1/prompt-templates/{prompt_template_id}/versionsList a Prompt template's versionsprompts:read1.55.0served
POST /v1/prompt-templates/{prompt_template_id}/versionsPublish the Prompt template draft as a new versionprompts:write1.55.0served
GET /v1/prompt-templates/{prompt_template_id}/versions/{version}Read a Prompt template versionprompts:read1.55.0served
POST /v1/prompt-templates/{prompt_template_id}/versions/{version}/activateActivate a Prompt template versionprompts:write1.55.0served

Error codes added

experiment_conflict, prompt_eval_suite_archived, prompt_template_archived, prompt_template_in_use

Event types added

experiment.started, experiment.stopped, prompt_base.deprecated, prompt_evaluation.completed, prompt_template.version.published

Scopes added

prompts:admin, prompts:read, prompts:write