Agent Versioning - Drafts

Publish a draft

Changed on

Deprecated on the v2 branch model. Migrate to POST /agent/{id}/branches/{branchId}/draft/publish. When ENABLE_BRANCH_MODEL is on, this endpoint returns 409 versioning_v2_migration_required with the Deprecation: true header. See the migration guide.

Publish a draft as a new versioned release. Optionally activate it immediately.

post/agent/{id}/drafts/{draftId}/publish

Request

  • Base URL
    https://api.smallest.ai/atoms/v1
  • URL
    https://api.smallest.ai/atoms/v1/agent/{id}/drafts/{draftId}/publish
  • Auth
    HTTP bearer

Path parameters

idstring required

The agent ID.

draftIdstring required

The draft ID

Request body

labelstring nullable

Label for the published version

descriptionstring nullable

Description of the published version

activateboolean

Whether to immediately activate the version after publishing

Response

Draft published as a new version

statusboolean

Example response

{
  "status": true
}

Changes

    • warning

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

    • 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