publications

Promote or roll back a version

Make an existing version live or roll back to an earlier one. Send the live version you last read; a named open draft is rebased in the same transaction.

Send the target version and expected_head_version. Read the latter from agents_get at head.version; use null when the agent has no live publication.

post/api/v1/agents/{agent_id}/head

Request

  • Base URL: https://api.cumuluslabs.io
  • URL: https://api.cumuluslabs.io/api/v1/agents/{agent_id}/head
  • Auth: HTTP bearer

Path parameters

agent_idstring required

Request body

versioninteger required
expected_head_versioninteger nullable required
draft_idstring uuid nullable

Response

Move head to an existing version (manual promote or rollback), rebasing the named open draft in the same transaction

from_versioninteger nullable required
to_versioninteger required
digeststring required
movedboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.