Skip to main content
DELETE
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

Authorizations

X-Api-Key
string
header
required

API key for authentication

Path Parameters

testId
string<uuid>
required

The test ID (UUID)

projectId
string
required

The project ID. You can copy it from the project settings page or the project URL in the dashboard.

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