Delete file API
View as Markdown · Open in Claude Desktop
Permanently deletes an uploaded file or a result now, before its scheduled deletion. Ask the user first.
- Endpoint
DELETE /v1/files/{id}- MCP name
delete_file- Available in MCP sets
- core, generate, full, local_cloud
What it draws
- Does not draw from the allowance.
Input
| Name | Type | Required | Description |
|---|---|---|---|
file_id | string | yes | The file id. |
Output
| Name | Type | Required | Description |
|---|---|---|---|
deleted | boolean | yes |
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | yes |
Examples
Set NEATTRIM_API_KEY to your key, then copy an example. A tool that draws from your allowance reads an uploaded file: upload a sample file as in the quickstart and set VIDEO_FILE_ID (or AUDIO_FILE_ID, IMAGE_FILE_ID, SUBTITLES_FILE_ID) to its file_id. Any other id in an example, such as JOB_ID, is read from a variable of the same name.
curl -X DELETE "https://api.neattrim.com/v1/files/$FILE_ID" \
-H "Authorization: Bearer $NEATTRIM_API_KEY"Errors
401- UNAUTHENTICATED or INACTIVE
404- NOT_FOUND (also for other accounts' ids)
429- RATE_LIMITED
Limits
- Largest upload
- Free: 200 MB, Plus: 2 GB, Pro: 4 GB
- Jobs running at once
- Free: 2, Plus: 3, Pro: 6
- Requests a minute
- Free: 60, Plus: 60, Pro: 60