list
List stored clips.
Arguments for this operation
{ operation: "list" }Example
gatos.audio_clip({"operation":"list"})gatos.audio_clip
tool Camera and media
List, retrieve, chunk-upload, or delete stored audio clips.
- Use when
- Managing the clip store separately from playback channels.
- Availability
- audio_enabled and AudioStore limits.
Input
| Field | Type | Requirement | Description |
|---|---|---|---|
operation | string | Required | list, retrieve, upload, or delete. |
name | string | null | Optional · null | Clip name for retrieve, upload, or delete. |
offset | integer | Optional · 0 | Decoded byte offset for an upload chunk. |
complete | boolean | Optional · true | Finalize the upload after this chunk. |
data_base64 | string | null | Optional · null | Base64-encoded bytes for upload. |
Operation call shapes
Choose an operation below. Its required payload and a complete call stay together—there is no second table to cross-reference.
retrieve
Return metadata and MCP AudioContentBlock for known formats, otherwise an embedded binary resource.
Arguments for this operation
{ operation: "retrieve", name }Example
gatos.audio_clip({"operation":"retrieve","name":"launch.wav"})upload
Write a bounded base64 chunk through AudioStore.
Arguments for this operation
{ operation: "upload", name, data_base64, offset?: decoded_byte_offset, complete?: boolean }Example
gatos.audio_clip({"operation":"upload","name":"beep.wav","data_base64":"UklGRg==","offset":0,"complete":true})delete
Remove a clip.
Arguments for this operation
{ operation: "delete", name }Example
gatos.audio_clip({"operation":"delete","name":"beep.wav"})Call example
gatos.audio_clip({"operation":"retrieve","name":"launch.wav"})Result
Store metadata; retrieve additionally emits audio or embedded binary content.
Errors
- ENOENT for a missing clip; EFBIG/ENOSPC/EEXIST/EPERM for store limits; EINVAL for malformed base64.
Operational notes
- Known extensions include wav, mp3, ogg/oga, flac, m4a/mp4, and aac.
- The HTTP request framing limit is 24 MiB; use upload chunks.