Runs

Start an endpoint run

Changed on Oct 21, 2026

Start an execution of an endpoint. For a sync COMPLETED run the HTTP status FAITHFULLY MIRRORS the provider's own status (2xx → 2xx, provider 4xx/5xx → 4xx/5xx, request-timeout → 504); the body always carries the full run. A control gate returns a 200 BLOCKED run, and a run that exceeds its time budget returns 408 (TIMED_OUT). Async endpoints return a 202 acceptance ack — poll GET /v1/runs/{runId} for the result.

post/v1/run

Request

Base URL: https://api.monid.ai
URL: https://api.monid.ai/v1/run
Auth: HTTP bearer

Headers

X-Monid-Agent-Modelstring

Model driving the calling agent. Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

X-Monid-Agent-Harnessstring

Agent harness or client making the call (e.g. a coding agent, an agent framework). Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

X-Monid-Agent-Session-Idstring

Caller-side session identifier, so the calls of one agent session (discover → inspect → run → polling) can be correlated. Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

Request body

providerstring required

Provider slug.

endpointstring required

Endpoint path within the provider.

Example request

{
  "provider": "exa",
  "endpoint": "search"
}

Response

Terminal run — COMPLETED (sync execution, when the provider responded 2xx) or BLOCKED (a workspace control gate rejected the run). A COMPLETED run with a non-2xx provider status is returned with that same HTTP status and this body shape — EXCEPT a provider 402 (the upstream vendor's payment/quota failure, not your wallet), which is returned as 502.

Example response

{
  "providerResponse": {
    "httpStatus": 200
  }
}

Changes

Oct 21, 202647b1a281e325 Revision changes
- warning
  added the new byte enum value to the /////// response property for the response status
- warning
  added the new byte enum value to the ///////// response property for the response status
- warning
  added the new byte enum value to the ///// response property for the response status
- warning
  added the new byte enum value to the ///////// response property for the response status
- warning
  added the new byte enum value to the /////// response property for the response status
- warning
  added the new byte enum value to the ///////// response property for the response status
- warning
  added the new byte enum value to the ///// response property for the response status
- warning
  added the new byte enum value to the ///////// response property for the response status
- warning
  added the new byte enum value to the /// response property for the response status
- warning
  added the new byte enum value to the /// response property for the response status
- warning
  added the new byte enum value to the /// response property for the response status
- warning
  added the new byte enum value to the ///// response property for the response status
- warning
  added the new byte enum value to the ///// response property for the response status
- warning
  added the new byte enum value to the ///// response property for the response status
- warning
  added the new byte enum value to the / response property for the response status
- warning
  added the new byte enum value to the / response property for the response status
- warning
  added the new byte enum value to the / response property for the response status
- warning
  added the new byte enum value to the ///// response property for the response status
- warning
  added the new byte enum value to the ///// response property for the response status
- warning
  added the new byte enum value to the ///// response property for the response status
- warning
  added the new voice enum value to the ////// response property for the response status
- warning
  added the new voice enum value to the // response property for the response status
- warning
  added the new voice enum value to the // response property for the response status
Oct 20, 2026631143e91790 Revision changes
- info
  added the new optional header request parameter X-Monid-Agent-Harness
- info
  added the new optional header request parameter X-Monid-Agent-Model
- info
  added the new optional header request parameter X-Monid-Agent-Session-Id
- info
  removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status
- info
  removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status
- info
  removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status
- info
  removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status
- info
  removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status
- info
  removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status
- info
  removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status

Operation history (11 revisions)