TokenLab

파일 및 배치

메시지 배치 취소

처리 중인 메시지 배치를 취소합니다.

POST
/v1/messages/batches/{message_batch_id}/cancel

개요

처리 중인 메시지 배치의 취소를 요청합니다. 응답은 현재 상태를 보여줍니다. processing_status는 일반적으로 canceling이며, 이미 실행 중인 요청은 완료될 수 있습니다. 이미 종료된 배치는 변경되지 않은 상태로 반환됩니다.

참고 사항

  • 취소 후 processing_status가 ended가 될 때까지 배치를 조회하십시오. 시작되지 않았던 요청은 canceled 상태로 종료됩니다.
  • 존재하지 않거나 삭제된 배치는 404를 반환합니다. 아직 변경할 준비가 되지 않은 배치는 409를 반환하므로 나중에 다시 시도하십시오.
  • 취소는 배치를 삭제하지 않습니다. 배치를 제거하려면 종료된 후 삭제하십시오.

예시

요청

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

응답 예시

응답

200 OK
{
  "id": "msgbatch_01ABC123",
  "type": "message_batch",
  "processing_status": "canceling",
  "request_counts": {
    "processing": 1,
    "succeeded": 1,
    "errored": 0,
    "canceled": 0,
    "expired": 0
  },
  "ended_at": null,
  "created_at": "2026-11-01T10:00:00Z",
  "expires_at": "2026-11-02T10:00:00Z",
  "cancel_initiated_at": "2026-11-01T10:05:00Z",
  "archived_at": null,
  "results_url": null
}

주요 필드

processing_statusstring
취소가 진행 중일 때는 canceling, 완료되면 ended가 됩니다. 모든 취소 요청이 canceling을 반환한다고 가정하지 마십시오.
cancel_initiated_atstring|null
취소 요청이 수락된 시점이며, 그렇지 않은 경우 null입니다.

인증

BearerAuth
AuthorizationBearer <token>

API 키 인증입니다. 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