proving

Start a proving run (returns immediately, processes in background)

post/v3/proving/run

Request

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

Headers

mentium-workspace-idstring nullable

Request body

agent_idstring uuid required

Agent ID (for tracking)

scenario_idstring uuid required

Scenario to run

system_prompt_overridestring nullable

If provided, use this prompt instead of the agent's saved system prompt for the run

user_prompt_overridestring nullable

If provided, use this prompt instead of the agent's saved user prompt for the run

response_format_overrideobject nullable

If provided, use this output schema instead of the agent's saved response format for the run

tools_overridestring[] nullable

If provided, use these tools instead of the agent's saved tools for the run

releasestring nullable

The release a staging deploy's run tests

image_tagstring nullable

The image tag a staging deploy's run tests

Response

Successful Response

idstring required

agent_idstring required

agent_revision_idstring nullable

The revision this run evaluates, when it is one of a revision's runs

scenario_idstring required

status'pending' | 'running' | 'completed' | 'failed' required

passedboolean nullable

error_messagestring nullable

duration_secondsnumber nullable

recording_urlstring nullable

A phone run's call audio, agent left and carrier right: a one-hour link on GET /runs/{id}, null in lists and the stream

releasestring nullable

The release a staging deploy's run tested

image_tagstring nullable

The image tag a staging deploy's run tested

mentium_created_atstring date-time required

mentium_updated_atstring date-time required

Changes

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