---
title: "Bulk delete tests"
method: POST
path: "/api/v2/synthetics/tests/bulk-delete"
tags: ["Synthetics"]
---

# Bulk delete tests

`POST /api/v2/synthetics/tests/bulk-delete`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/synthetics/tests/bulk-delete`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `synthetics_write`

## Request body

- DeletedTestsRequestDeleteRequest: Request body for bulk deleting Synthetic tests.
  - `data` DeletedTestsRequestDelete, required: Data object for a bulk delete Synthetic tests request.
    - `attributes` DeletedTestsRequestDeleteAttributes, required: Attributes for a bulk delete Synthetic tests request.
      - `force_delete_dependencies` boolean: Whether to force deletion of tests that have dependent resources.
      - `public_ids` string[], required: List of public IDs of the Synthetic tests to delete.
    - `id` string: An optional identifier for the delete request.
    - `type` 'delete_tests_request': Type for the bulk delete Synthetic tests request, `delete_tests_request`.

## Response `200`

OK

- DeletedTestsResponse: Response containing the list of deleted Synthetic tests.
  - `data` DeletedTestResponseData[]: List of deleted Synthetic test data objects.
    - `attributes` DeletedTestResponseDataAttributes: Attributes of a deleted Synthetic test, including deletion timestamp and public ID.
      - `deleted_at` string: Deletion timestamp of the Synthetic test ID.
      - `public_id` string: The Synthetic test ID deleted.
    - `id` string: The public ID of the deleted Synthetic test.
    - `type` 'delete_tests': Type for the bulk delete Synthetic tests response, `delete_tests`.

## Other responses

- `400`: API error response.
- `404`: API error response.
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)