Skip to main content
POST
Error

Path Parameters

projectUuid
string<uuid>
required

Stringified UUIDv4. See RFC 4112

Pattern: [0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-4[0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}

Body

application/json
entryPoint
enum<string>
required

Product surface that accepted the run.

Available options:
homepage,
ask_ai
mcpServerUuids
string[]
required

Agent-attached MCP servers enabled for this run.

promptUuid
string
required

Thread message that captured this prompt.

threadUuid
string
required

Agent thread to attach the run to. Must be owned by the caller.

agentUuid
string
required

Agent whose complete runtime configuration will execute this run.

prompt
string
required
effort
enum<string>

Server-owned execution budget tier. Defaults to medium.

Available options:
high,
medium,
low,
xhigh

Response

Accepted

results
object
required
status
enum<string>
required
Available options:
ok