publications

Publish a version

Compile a draft into an immutable version. Set live: false to create a test version; the default makes it live for new runs.

Use the version returned by drafts_validate.

  • live: false creates a test publication and keeps the live head unchanged. Run it with test_runs_create, then promote it with publications_promote.
  • live: true is the default and makes the publication live immediately.
  • keep_draft: true keeps the working draft open for further edits.
post/api/v1/agents/{agent_id}/publications

Request

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

Path parameters

agent_idstring required

Request body

draft_idstring uuid required
expected_revisioninteger required
versioninteger required
liveboolean
keep_draftboolean
expected_head_versioninteger nullable

Response

Publish the draft as the next immutable version; moves head unless live is false (201; replay 200)

published_atstring date-time required
is_headboolean required
testboolean required

Changes

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