Skip to main content
POST
Run Agent

Authorizations

Authorization
string
header
required

Your Mindcase API key: Authorization: Bearer mk_live_...

Headers

Idempotency-Key
string

Optional, recommended. A unique string per run (e.g. a UUID). Retrying with the same key within 24h returns the original job instead of starting and charging a second one; the response carries X-Idempotent-Replay: true. The same key with a different agent or params returns 422 idempotency_key_reused.

Required string length: 8 - 255

Path Parameters

group
string
required
slug
string
required

Query Parameters

wait
boolean
default:false

Opt-in synchronous mode: hold the request open until the run completes (or the wait times out) and return rows inline. Ignored for MCP-sourced runs.

wait_timeout
number | null

Seconds to wait when wait=true (clamped to the server ceiling, default 60). On timeout you get {job_id, status:'running'} and poll /jobs/{id} + /jobs/{id}/results as usual.

Body

application/json
params
Params · object

Agent parameters

Response

Successful Response