Dateien & Batch-Jobs

Nachrichten-Batch löschen

Löscht einen Nachrichten-Batch, der beendet wurde.

DELETE
/v1/messages/batches/{message_batch_id}

Überblick

Löschen Sie einen Nachrichten-Batch, der beendet wurde. Nach dem Löschen erscheint der Batch nicht mehr in der Liste, und sein Status sowie seine Ergebnisse sind nicht mehr verfügbar (404).

Hinweise

  • Löschen Sie den Batch erst, nachdem er beendet wurde und TokenLab die Nutzung abgerechnet hat. Davor gibt die Anfrage den Status 409 mit dem Fehlertyp conflict_error zurück. Brechen Sie einen Batch ab, der noch verarbeitet wird, warten Sie, bis er beendet ist, und löschen Sie ihn dann.
  • Das Löschen hat keinen Einfluss auf die bereits angefallenen Kosten.
  • Laden Sie die Ergebnisse herunter, bevor Sie den Batch löschen.

Beispiel

Anfrage

cURL
curl -X DELETE "https://api.tokenlab.sh/v1/messages/batches/msgbatch_01ABC123" \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01"

Antwortbeispiel

Antwort

200 OK
{
  "id": "msgbatch_01ABC123",
  "type": "message_batch_deleted"
}

Wichtige Felder

idstring
ID des gelöschten Batches.
typestring
Immer message_batch_deleted.

Autorisierung

BearerAuth
AuthorizationBearer <token>

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

Ort: header

Pfadparameter

message_batch_id*string

Bezeichner des Nachrichten-Batch

Antwort

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json