---
title: "Bulk delete AI agent items"
method: POST
path: "/api/v2/agent-items/bulk-delete"
tags: ["EngageItem"]
---

# Bulk delete AI agent items

`POST /api/v2/agent-items/bulk-delete`

## Request

- Base URL: `https://api.instantly.ai`
- URL: `https://api.instantly.ai/api/v2/agent-items/bulk-delete`
- Auth: HTTP bearer

Requires one of the following scopes: `all:delete`, `all:all`

## Request body

- object
  - `items` object[], required
    - `id` string, uuid, required
    - `type` 'ai_agent' | 'automation'

## Response `200`

IDs of successfully deleted agents

- object
  - `deleted_ids` string[], required
  - `failed` object[], required
    - `id` string, uuid, required
    - `reason` string, required

## Other responses

- `401`: This request is unauthorized (either the Authorization header is missing or invalid, or the API key has been revoked)
- `402`: This request cannot be fulfilled because the workspace does not have an active paid plan
- `404`: The requested resource was not found
- `429`: You have exceeded the rate limit. Please check the rate limit docs for more information.

## Changes

- **2026-11-03** `c781051105a8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/instantly/apis/api-explorer/changes/api/v2/agent-items/bulk-delete/post.md)

---

[API](https://skmtc.dev/instantly/apis/api-explorer.md) - [All operations](https://skmtc.dev/instantly/apis/api-explorer/llms.txt) - [OpenAPI document](https://skmtc.dev/instantly/apis/api-explorer/revisions/adcd5b3299da?raw)