Arquivos e lotes

Excluir arquivo

Exclui um arquivo enviado pertencente à organização atual.

DELETE
/v1/files/{file_id}

Visão geral

Exclui um arquivo criado por /v1/files. Arquivos Batch e arquivos de referência de imagem criados pela TokenLab retornam um objeto deleted compatível com OpenAI.

Quando a requisição usa o modo de compatibilidade com Anthropic Files, a mesma rota exclui o arquivo no estilo Anthropic do workspace vinculado.

Observações

  • Excluir um arquivo não cancela jobs Batch que já o referenciam.
  • file ids ausentes ou não autorizados retornam um erro público not-found sem expor estado de roteamento.
  • Exclua arquivos de referência de imagem somente quando nenhuma requisição pendente de edição de imagem precisar deles.

Exemplo

Requisição

cURL
curl -X DELETE "https://api.tokenlab.sh/v1/files/file_abc123" \
  -H "Authorization: Bearer sk-your-api-key"

Requisição / Resposta

Use o painel OpenAPI interativo acima para o schema exato.

{  "id": "string",  "object": "file",  "deleted": true}

Autorização

BearerAuth
AuthorizationBearer <token>

Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.

Local: header

Parâmetros de caminho

file_id*string

ID do arquivo retornado pela Files API.

Cabeçalhos

anthropic-beta?string

Inclua files-api-2025-04-14 para usar o modo Anthropic Files API.

Resposta

application/json

application/json

application/json