TokenLab

檔案與批次

刪除訊息批次 (Delete Message Batch)

刪除已結束的訊息批次。

DELETE
/v1/messages/batches/{message_batch_id}

概覽

刪除一個已結束的訊息批次。刪除後,該批次將不再顯示於列表中,其狀態與結果也將無法再存取(回傳 404)。

注意事項

  • 請僅在批次結束且 TokenLab 已結算其用量後進行刪除。在此之前,請求將回傳 409 並顯示 conflict_error 錯誤類型。若批次仍在處理中,請先取消該批次,等待其結束後再進行刪除。
  • 刪除操作不會變更您已被收取的費用。
  • 請在刪除批次前先下載結果。

範例

請求

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"

回應範例

回應

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

重要欄位

idstring
已刪除批次的 ID。
typestring
固定為 message_batch_deleted。

授權

BearerAuth
AuthorizationBearer <token>

API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。

位置: header

路徑參數

message_batch_id*string

訊息批次識別碼

回應

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json