Stop Run

POST /v1/runs/:runId/stop

Stop a run that is READY or RUNNING. Terminal runs (COMPLETED, FAILED) cannot be stopped.

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer <api-key>`
`x-workspace-id`	Yes	Workspace ID — see `GET /v1/auth/workspaces`

Path Parameters

Parameter	Type	Description
`runId`	string	The run ID to stop

Example Request

curl -X POST "https://api.monid.ai/v1/runs/01HXYZ1234567890ABCDEF/stop" \
  -H "Authorization: Bearer monid_live_..." \
  -H "x-workspace-id: ws_abc123"

const res = await fetch(
  "https://api.monid.ai/v1/runs/01HXYZ1234567890ABCDEF/stop",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer monid_live_...",
      "x-workspace-id": "ws_abc123",
    },
  },
);

200 OK

Returns the run in its updated state.

{
  "runId": "01HXYZ1234567890ABCDEF",
  "status": "FAILED",
  "completedAt": "2026-03-28T10:30:45.000Z"
}

Stopped runs settle as FAILED. Any partial charges incurred before the stop are still applied.

GET /v1/runs/:runId GET /v1/wallet/balance

Auth

Endpoints

Runs

Wallet

Headers

Path Parameters

Example Request

200 OK

​Headers

​Path Parameters

​Example Request

​200 OK

Headers

Path Parameters

Example Request

200 OK