Skip to main content
POST
Create an agent run

Authorizations

Authorization
string
header
required

A ManyPI API key (mpi_...) from Settings → API keys, or an OAuth 2.1 access token obtained through the MCP consent flow.

Body

application/json
goal
string
required

What you want ManyPI to do, in plain language.

conversation_id
string<uuid>

Attach to an existing conversation.

playbook
string

A named behaviour, e.g. lead_generation.

sources
object[]
output_schema
object

A JSON schema the result must conform to.

max_steps
integer
max_pages
integer

Response

The run was created.

run_id
string<uuid>
conversation_id
string<uuid>
status
string