MEmentium
v3
ai-agents

Publish a revision

Makes the revision live: the draft's new revision, or an earlier one to roll back to. Refused with 409 while a Mentium safety check that applies has not passed on it, unless an override reason is given.

post/v3/ai-agents/{agent_id}/revisions/{revision_id}/publish

Request

  • Base URL
    https://api.mentium.io (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Path parameters

agent_idstring uuid required
revision_idstring uuid required

Headers

mentium-workspace-idstring nullable

Request body

messagestring nullable

What this version changes, in a sentence or two, like a commit message; kept on the revision when it is first published

override_reasonstring nullable

Why to publish although a Mentium safety check failed, has not finished or never ran; kept on the revision

Response

Successful Response

idstring required
agent_idstring required
revision_numberinteger required
status'candidate' | 'evaluated' | 'published' required
is_liveboolean

The agent runs this revision now

config_digeststring required
platform_contract_digeststring nullable
suite_digeststring nullable
gate_passedboolean nullable

Every applicable Mentium safety check passed; null until evaluated, and for revisions never tested

gate_override_reasonstring nullable
messagestring nullable

What the version changes, written when it was first published

gate_overridden_by_emailstring nullable
created_by_emailstring nullable
published_by_emailstring nullable
based_on_revision_numberinteger nullable

The version that was live when this one was frozen: the version it was changed from

created_by_impersonator_emailstring nullable

The admin acting as the user who created it

published_by_impersonator_emailstring nullable

The admin acting as the user who published it

gate_overridden_by_impersonator_emailstring nullable

The admin acting as the user who overrode the gate

failed_safety_checksstring[]

Attached safety checks that did not pass

run_idsstring[]
attached_since_testedstring[]

Tests the agent runs now that this revision was not tested on

replaces_live_revision_numberinteger nullable

The live version that making this one live replaces, when this one was made from an earlier version

phone_call_countinteger

Phone calls this revision answered

session_countinteger

Chat, email and workflow sessions this revision ran

evaluated_atstring date-time nullable
published_atstring date-time nullable
mentium_created_atstring date-time required

Changes

No recorded changes to this operation across all 2 revisions of this API.