---
title: "Bulk delete Agents"
method: DELETE
path: "/v1/agents/bulk-delete"
tags: ["Agent Management"]
---

# Bulk delete Agents

`DELETE /v1/agents/bulk-delete`

Delete multiple agents by their IDs. Only the creator can delete their agents.

## Request body

- DeleteAgentsInput
  - `agent_ids` string[], required — The list of agent IDs to delete.

## Response `200`

Successful Response

- BulkDeleteResponse — Response after deleting multiple agents.
  - `request_metadata` ResponseMeta
    - `request_id` string, nullable — Unique request identifier for tracing and support.
  - `message` string, required — Summary of the deletion operation.
  - `deleted_ids` string[] — IDs of the agents that were successfully deleted.
  - `error_details` object[], nullable — Details of agents that failed to be deleted.

## Other responses

- `422` — Validation Error

## Changes

- **2026-03-13** `8dbd0fc3f906` — 1 info
  - added the optional property `error_details` to the response with the `200` status
- **2026-02-11** `c9a09aaa6236` — 1 breaking, 4 info
  - the response's body type changed from no type to `object` for status `200`
  - api tag `Agent Management` added
  - added the optional property `deleted_ids` to the response with the `200` status
  - added the optional property `request_metadata` to the response with the `200` status
  - …1 more
- **2025-03-30** `f8b1d57c6f96` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/svahnar/apis/svahnar-apis/changes/v1/agents/bulk-delete/delete.md)

---

[API](https://skmtc.dev/svahnar/apis/svahnar-apis.md) · [All operations](https://skmtc.dev/svahnar/apis/svahnar-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/svahnar/svahnar-apis/revisions/02cca47c900a/schema)