파일 및 배치
메시지 배치 취소
처리 중인 메시지 배치를 취소합니다.
개요
처리 중인 메시지 배치의 취소를 요청합니다. 응답은 현재 상태를 보여줍니다. processing_status는 일반적으로 canceling이며, 이미 실행 중인 요청은 완료될 수 있습니다. 이미 종료된 배치는 변경되지 않은 상태로 반환됩니다.
참고 사항
- 취소 후
processing_status가ended가 될 때까지 배치를 조회하십시오. 시작되지 않았던 요청은canceled상태로 종료됩니다. - 존재하지 않거나 삭제된 배치는
404를 반환합니다. 아직 변경할 준비가 되지 않은 배치는409를 반환하므로 나중에 다시 시도하십시오. - 취소는 배치를 삭제하지 않습니다. 배치를 제거하려면 종료된 후 삭제하십시오.
요청
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"응답
{
"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