Skip to main content
DELETE
/
tests
/
{testId}
curl -X DELETE "https://nunu.ai/api/v1/tests/a5060a07-d386-4269-98ce-b33fb894201e" \
  -H "X-Api-Key: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "delete_associated_jobs": true }'

{ "id": "a5060a07-d386-4269-98ce-b33fb894201e", "deleted": true }

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:edit-tests
Permanently delete a test case from your project. By default, deletion is rejected with 409 if the test has associated runs. Pass delete_associated_jobs=true to also delete the related jobs (which is required to delete a test that has been run before).

​
Path Parameters

​
testId
string
required
The test ID (UUID)

​
Request Body

​
delete_associated_jobs
boolean
default:"false"
When true, also delete the jobs (and runs) that referenced this test.
​
force_delete
boolean
default:"false"
When true, bypass safety checks that would otherwise prevent deletion. Intended for cleanup scenarios; use with care.

​
Response

​
id
string
required
ID of the deleted test (echoes the path param)
​
deleted
boolean
required
Always true on success
curl -X DELETE "https://nunu.ai/api/v1/tests/a5060a07-d386-4269-98ce-b33fb894201e" \
  -H "X-Api-Key: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "delete_associated_jobs": true }'

{ "id": "a5060a07-d386-4269-98ce-b33fb894201e", "deleted": true }

Authorizations

​
X-Api-Key
string
header
required

API key for authentication

Path Parameters

​
testId
string<uuid>
required

The test ID (UUID)

Body

application/json
​
delete_associated_jobs
boolean
default:false
​
force_delete
boolean
default:false

Response

Test deleted

Standard response for DELETE operations on tests, test plans, and shared steps.

​
id
string
required

ID of the deleted resource (echoes the path param)

​
deleted
enum<boolean>
required

Always true on success

Available options:
true