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

# Bulk delete suites

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

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/synthetics/suites/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

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

## Response `200`

OK

- DeletedSuitesResponse: Response containing the list of deleted Synthetic test suites.
  - `data` DeletedSuiteResponseData[]: List of deleted Synthetic suite data objects.
    - `attributes` DeletedSuiteResponseDataAttributes: Attributes of a deleted Synthetic test suite, including deletion timestamp and public ID.
      - `deleted_at` string: Deletion timestamp of the Synthetic suite ID.
      - `public_id` string: The Synthetic suite ID deleted.
    - `id` string: The public ID of the deleted Synthetic test suite.
    - `type` 'suites': Type for the Synthetics suites responses, `suites`.

## Other responses

- `400`: 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)