---
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

---

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