Delete File
Delete File
Path parameters
ID of the File.
Headers
"anthropic-version": optional stringThe version of the Claude API you want to use.
The version of the Claude API you want to use.
Read more about versioning and our version history here.
"anthropic-beta": optional array of AnthropicBetaOptional header to specify the beta version(s) you want to use.
Optional header to specify the beta version(s) you want to use.
"message-batches-2024-09-24"Deprecated
"prompt-caching-2024-07-31"Deprecated
"pdfs-2024-09-25"Deprecated
"token-counting-2024-11-01"Deprecated
"token-efficient-tools-2025-02-19"Deprecated
"files-api-2025-04-14"Deprecated
"extended-cache-ttl-2025-04-11"Deprecated
"skills-2025-10-02"Deprecated
"cache-diagnosis-2026-04-07"Deprecated
"ce-user-management-2026-07-13"Deprecated
"anthropic-workspace-id": optional stringOptional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).
Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).
Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.
Returns
BetaDeletedFile object{ type: "file_deleted", id }
type: optional "file_deleted"Deleted object type.
Deleted object type.
For file deletion, this is always "file_deleted".
ID of the deleted file.
Errors
Any method can also return the general HTTP errors.
Each code below is the value of error.details.error_code in the response body.
The API key belongs to the Claude Code workspace, and the user who created it is no longer a member of the organization or of that workspace.
The workspace's customer-managed encryption key is disabled or revoked. Re-enable the key, then retry.
The key management service's network access controls blocked the request to the workspace's customer-managed encryption key. The key itself may be healthy.
Anthropic has disabled the organization for trust and safety reasons. An organization disabled for any other reason, such as billing, does not get this code. appeal_url, when present, is where the organization can appeal.
curl https://api.anthropic.com/v1/files/$FILE_ID \
-X DELETE \
-H 'anthropic-version: 2026-10-21' \
-H "Authorization: Bearer $ANTHROPIC_API_KEY"{
"id": "file_011CNha8iCJcU1wXNR6q4V8w",
"type": "file_deleted"
}Returns Examples
{
"id": "file_011CNha8iCJcU1wXNR6q4V8w",
"type": "file_deleted"
}