Skip to main content
POST
/
runs
/
stop
curl -X POST "https://nunu.ai/api/v1/runs/stop" \
  -H "X-Api-Key: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "job_ids": ["f80f6230-3a4f-431a-9d55-d11b867fed4e"]
  }'

{
  "ok": true,
  "message": "Successfully stopped 2 job(s)",
  "received_count": 2,
  "stopped_count": 2,
  "results": [
    {
      "job_id": "f80f6230-3a4f-431a-9d55-d11b867fed4e",
      "ok": true,
      "status": 200,
      "message": "Job stopped"
    },
    {
      "job_id": "0a9f9c52-8917-4f47-bb72-b0093c200bed",
      "ok": true,
      "status": 200,
      "message": "Job stopped"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://api-docs.nunu.ai/llms.txt

Use this file to discover all available pages before exploring further.

Permission Required: project:operate-runs
Stop one or more running tests. Only jobs belonging to your project will be stopped.

​
Request Body

​
job_ids
string[]
required
Array of job IDs to stop (minimum 1). Job IDs are returned when you start a run.

​
Response

​
ok
boolean
required
true if all jobs stopped successfully
​
message
string
required
Human-readable summary (e.g., “Successfully stopped 2 job(s)”)
​
received_count
integer
required
Number of job IDs provided in the request
​
stopped_count
integer
required
Number of jobs actually stopped
​
results
Result[]
required
Per-job results
Stopping a run will terminate it immediately. Any in-progress test steps will be marked as incomplete.
curl -X POST "https://nunu.ai/api/v1/runs/stop" \
  -H "X-Api-Key: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "job_ids": ["f80f6230-3a4f-431a-9d55-d11b867fed4e"]
  }'

{
  "ok": true,
  "message": "Successfully stopped 2 job(s)",
  "received_count": 2,
  "stopped_count": 2,
  "results": [
    {
      "job_id": "f80f6230-3a4f-431a-9d55-d11b867fed4e",
      "ok": true,
      "status": 200,
      "message": "Job stopped"
    },
    {
      "job_id": "0a9f9c52-8917-4f47-bb72-b0093c200bed",
      "ok": true,
      "status": 200,
      "message": "Job stopped"
    }
  ]
}

Authorizations

​
X-Api-Key
string
header
required

API key for authentication

Body

application/json
​
job_ids
string[]
required

Array of job IDs to stop

Minimum array length: 1

Response

All jobs stopped successfully

​
ok
boolean
​
message
string
​
received_count
integer
​
stopped_count
integer
​
results
object[]