Dateien & Batch-Jobs

Datei löschen

Löscht eine hochgeladene Datei, die der aktuellen Organisation gehört.

DELETE
/v1/files/{file_id}

Übersicht

Löscht eine über /v1/files erstellte Datei. Batch-Dateien und von TokenLab erstellte Bildreferenzdateien geben ein OpenAI-kompatibles deleted-Objekt zurück.

Wenn die Anfrage den Anthropic-Files-Kompatibilitätsmodus verwendet, löscht dieselbe Route die Anthropic-ähnliche Datei aus dem gebundenen Workspace.

Hinweise

  • Das Löschen einer Datei bricht Batch-Jobs, die sie bereits referenzieren, nicht ab.
  • Fehlende oder nicht autorisierte file ids geben einen öffentlichen not-found-Fehler zurück, ohne Routingstatus offenzulegen.
  • Löschen Sie Bildreferenzdateien erst, wenn keine ausstehende Bildbearbeitungsanfrage sie mehr benötigt.

Beispiel

Anfrage

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

Anfrage / Antwort

Verwenden Sie das interaktive OpenAPI-Panel oben für das genaue Schema.

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

Autorisierung

BearerAuth
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Pfadparameter

file_id*string

Von der Files API zurückgegebene Datei-ID.

Header

anthropic-beta?string

Fügen Sie files-api-2025-04-14 hinzu, um den Anthropic Files API-Modus zu verwenden.

Antwort

application/json

application/json

application/json