> ## Documentation Index > Fetch the complete documentation index at: https://oma-codex-339-workspace-permissions.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 删除文件 > 通过 OMA API 删除文件。 每个请求都必须发送 `anthropic-beta: files-api-2025-04-14`。 ## OpenAPI ````yaml /openapi/oma.zh.json delete /v1/files/{file_id} openapi: 3.1.0 info: title: OMA API 参考 version: 1.0.0 description: Open Managed Agents 应用 API 参考。 servers: - url: http://localhost:38080 description: 本地 OMA 服务器 security: - omaApiKey: [] - omaBearer: [] paths: /v1/files/{file_id}: delete: summary: 删除文件 operationId: beta_delete_file_v1_files__file_id__delete parameters: - name: beta in: query required: true description: 为此接口启用 Beta API 合同，必须为 `true`。 schema: type: boolean enum: - true - name: file_id in: path required: true schema: type: string description: File 的 ID。 title: 文件 ID description: File 的 ID。 - name: anthropic-beta in: header required: true schema: type: string items: type: string description: |- 用于指定要使用的 beta 版本的可选请求头。 要使用多个 beta，请使用逗号分隔的列表（如 `beta1,beta2`），或为每个 beta 分别指定该请求头。 title: Anthropic-Beta x-stainless-override-schema: x-stainless-param: betas x-stainless-extend-default: true type: array description: 用于指定一个或多个 Beta 版本的可选请求头。 items: $ref: '#/components/schemas/AnthropicBeta' x-default: files-api-2025-04-14 description: |- 用于指定要使用的 beta 版本的可选请求头。 要使用多个 beta，请使用逗号分隔的列表（如 `beta1,beta2`），或为每个 beta 分别指定该请求头。 - name: anthropic-version in: header required: false schema: type: string description: |- 你想使用的 OMA API 版本。 在此处阅读更多关于版本控制和我们版本历史的信息。 title: Anthropic-Version description: |- 你想使用的 OMA API 版本。 在此处阅读更多关于版本控制和我们版本历史的信息。 responses: '200': description: 成功的响应 content: application/json: schema: $ref: '#/components/schemas/BetaFileDeleteResponse' 4XX: description: |- 错误响应。 详见我们的错误文档。 content: application/json: schema: $ref: '#/components/schemas/BetaErrorResponse' components: schemas: BetaFileDeleteResponse: properties: id: type: string title: ID description: 已删除文件的 ID。 examples: - file_011CNha8iCJcU1wXNR6q4V8w type: type: string const: file_deleted title: 类型 description: |- 已删除对象的类型。 对于文件删除，该值始终为 `"file_deleted"`。 default: file_deleted type: object required: - id title: FileDeleteResponse BetaErrorResponse: properties: error: discriminator: mapping: api_error: $ref: '#/components/schemas/BetaAPIError' authentication_error: $ref: '#/components/schemas/BetaAuthenticationError' billing_error: $ref: '#/components/schemas/BetaBillingError' invalid_request_error: $ref: '#/components/schemas/BetaInvalidRequestError' not_found_error: $ref: '#/components/schemas/BetaNotFoundError' overloaded_error: $ref: '#/components/schemas/BetaOverloadedError' permission_error: $ref: '#/components/schemas/BetaPermissionError' rate_limit_error: $ref: '#/components/schemas/BetaRateLimitError' timeout_error: $ref: '#/components/schemas/BetaGatewayTimeoutError' propertyName: type oneOf: - $ref: '#/components/schemas/BetaInvalidRequestError' - $ref: '#/components/schemas/BetaAuthenticationError' - $ref: '#/components/schemas/BetaBillingError' - $ref: '#/components/schemas/BetaPermissionError' - $ref: '#/components/schemas/BetaNotFoundError' - $ref: '#/components/schemas/BetaRateLimitError' - $ref: '#/components/schemas/BetaGatewayTimeoutError' - $ref: '#/components/schemas/BetaAPIError' - $ref: '#/components/schemas/BetaOverloadedError' title: 错误 request_id: anyOf: - type: string - type: 'null' default: null title: 请求 ID type: const: error default: error title: 类型 type: string required: - error - request_id - type title: ErrorResponse type: object BetaAPIError: properties: message: default: Internal server error title: 消息 type: string type: const: api_error default: api_error title: 类型 type: string required: - message - type title: APIError type: object BetaAuthenticationError: properties: message: default: Authentication error title: 消息 type: string type: const: authentication_error default: authentication_error title: 类型 type: string required: - message - type title: AuthenticationError type: object BetaBillingError: properties: message: default: Billing error title: 消息 type: string type: const: billing_error default: billing_error title: 类型 type: string required: - message - type title: BillingError type: object BetaInvalidRequestError: properties: message: default: Invalid request title: 消息 type: string type: const: invalid_request_error default: invalid_request_error title: 类型 type: string required: - message - type title: InvalidRequestError type: object BetaNotFoundError: properties: message: default: Not found title: 消息 type: string type: const: not_found_error default: not_found_error title: 类型 type: string required: - message - type title: NotFoundError type: object BetaOverloadedError: properties: message: default: Overloaded title: 消息 type: string type: const: overloaded_error default: overloaded_error title: 类型 type: string required: - message - type title: OverloadedError type: object BetaPermissionError: properties: message: default: Permission denied title: 消息 type: string type: const: permission_error default: permission_error title: 类型 type: string required: - message - type title: PermissionError type: object BetaRateLimitError: properties: message: default: Rate limited title: 消息 type: string type: const: rate_limit_error default: rate_limit_error title: 类型 type: string required: - message - type title: RateLimitError type: object BetaGatewayTimeoutError: properties: message: default: Request timeout title: 消息 type: string type: const: timeout_error default: timeout_error title: 类型 type: string required: - message - type title: GatewayTimeoutError type: object securitySchemes: omaApiKey: type: apiKey in: header name: X-Api-Key description: OMA 工作区 API 密钥。 x-default: sk-ant-local-default omaBearer: type: http scheme: bearer description: 以 Bearer 令牌形式发送的 OMA 工作区 API 密钥。 ````