---
title: "Bulk delete cached audio entries"
method: POST
path: "/v1/agents/{agentId}/audio-cache/bulk-delete"
tags: ["Audio Cache"]
---

# Bulk delete cached audio entries

`POST /v1/agents/{agentId}/audio-cache/bulk-delete`

Delete multiple audio cache entries by ID in a single request. Operates best-effort — returns which IDs were successfully deleted and which failed, so partial failures can be retried. Maximum 20 IDs per request.

## Request body

- BulkDeleteAudioCacheRequest
  - `ids` string[], required — List of audio cache entry IDs to delete (max 20)

## Response `200`

Per-ID delete results

- BulkDeleteAudioCacheResponse
  - `deleted` string[], required — IDs that were successfully deleted
  - `failed` string[], required — IDs that failed to delete

## Other responses

- `400` — Invalid request – `ids` must contain between 1 and 20 entries
- `401` — Unauthorized – missing or invalid API key
- `403` — Forbidden – the API key does not have `write` permission on the audio cache resource

---

[API](https://skmtc.net/poly/apis/polyai-agents-api.md) · [All operations](https://skmtc.net/poly/apis/polyai-agents-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/poly/polyai-agents-api/versions/76f3c606e395/schema)