Agent Versioning - Versions
Activate a version
Deprecated on the v2 branch model. Migrate to POST /agent/{id}/branches/{branchId}/live or POST /agent/{id}/branches/{branchId}/revisions/{revisionId}/restore. When ENABLE_BRANCH_MODEL is on, this endpoint returns 409 versioning_v2_migration_required with the Deprecation: true header. See the migration guide.
| Set a published version as the active version for the agent. The previously active version is deactivated. This does not modify the version's config — it only changes which version serves live traffic. Activation is idempotent: if the version is already active, the endpoint returns that version without changing config.
patch/agent/{id}/versions/{versionId}/activate
Path parameters
idstring required
The agent ID.
versionIdstring required
The published version ID
Response
Version activated successfully
Example response
{
"status": true
}