v126

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-08-04957391.2 MB
Files

Delete a file

Deletes a file owned by the requesting workspace. Deletion is irreversible.

delete/files/{file_id}

Path parameters

file_idstring required
Example:or_file_011CNha8iCJcU1wXNR6q4V8w

Query parameters

workspace_idstring uuid

Workspace to scope the request to. Defaults to the caller’s default workspace.

Example:a103d8b6-42f0-4e50-9a3c-bf41e2c3c1a7

Workspace to scope the request to. Defaults to the caller’s default workspace.

provider'openai' | 'anthropic'

Store or read this file on the named provider using your own API key for it. Omit to use OpenRouter storage.

Example:openai

Store or read this file on the named provider using your own API key for it. Omit to use OpenRouter storage.

Response

The file was deleted.

OR
OR

Example response

{
  "_shape": "openrouter",
  "id": "or_file_011CNha8iCJcU1wXNR6q4V8w",
  "type": "file_deleted"
}