Claude Platform Docs

Delete File

DeletedFile files().delete(params = FileDeleteParams.none(), requestOptions = RequestOptions.none())
DELETE/v1/files/{file_id}

Delete File

Parameters
FileDeleteParams params
Optional<String> fileId⁠Path parameter

ID of the File.

Optional<String> workspaceId⁠Header parameter

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
class DeletedFile { type; id; }
Optional<Type> type

Deleted object type.

For file deletion, this is always "file_deleted".

String id

ID of the deleted file.

Errors

Any method can also return the general HTTP errors.

ClaudeCodeKeyCreatorNotMemberExceptionHTTP status 400error code claude_code_key_creator_not_member

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.

CmekKeyDisabledExceptionHTTP status 400error code cmek_key_disabled

The workspace's customer-managed encryption key is disabled or revoked. Re-enable the key, then retry.

CmekKeyNetworkBlockedExceptionHTTP status 400error code cmek_key_network_blocked

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.

OrganizationOnHoldExceptionHTTP status 400error code organization_on_hold

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.

Delete File
package com.anthropic.example;

import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.files.DeletedFile;
import com.anthropic.models.files.FileDeleteParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        AnthropicClient client = AnthropicOkHttpClient.fromEnv();

        DeletedFile deletedFile = client.files().delete("file_id");
    }
}
Returns Examples
Response 200
{
  "id": "file_011CNha8iCJcU1wXNR6q4V8w",
  "type": "file_deleted"
}