---
title: "Delete tests"
method: POST
path: "/api/v1/synthetics/tests/delete"
tags: ["Synthetics"]
---

# Delete tests

`POST /api/v1/synthetics/tests/delete`

Delete multiple Synthetic tests by ID.

## Request body

- SyntheticsDeleteTestsPayload — A JSON list of the ID or IDs of the Synthetic tests that you want to delete.
  - `force_delete_dependencies` boolean — Delete the Synthetic test even if it's referenced by other resources (for example, SLOs and composite monitors).
  - `public_ids` string[] — An array of Synthetic test IDs you want to delete.

## Response `200`

OK.

- SyntheticsDeleteTestsResponse — Response object for deleting Synthetic tests.
  - `deleted_tests` SyntheticsDeletedTest[] — Array of objects containing a deleted Synthetic test ID with the associated deletion timestamp.
    - `deleted_at` string, date-time — Deletion timestamp of the Synthetic test ID.
    - `public_id` string — The Synthetic test ID deleted.

## Other responses

- `400` — - JSON format is wrong - Test cannot be deleted as it's used elsewhere (as a sub-test or in an uptime widget) - Some IDs are not owned by the user
- `403` — Forbidden
- `404` — - Tests to be deleted can't be found - Synthetic is not activated for the user
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v1.md) · [All operations](https://skmtc.net/datadog/apis/api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v1/revisions/ca5871004d26/schema)