Agent Versioning - Versions

Activate a version

Changed on

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

Request

  • Base URL
    https://api.smallest.ai/atoms/v1
  • URL
    https://api.smallest.ai/atoms/v1/agent/{id}/versions/{versionId}/activate
  • Auth
    HTTP bearer

Path parameters

idstring required

The agent ID.

versionIdstring required

The published version ID

Response

Version activated successfully

statusboolean

Example response

{
  "status": true
}

Changes

  • 49ce8525306eRevision changes
    • warning

      added the new multi_agents enum value to the / response property for the response status

  • a9c928635312Revision changes
    • breaking

      added the pattern ^[a-f\d]{24}$ to the path request parameter id

    • info

      endpoint deprecated

    • info

      added the non-success response with the status