---
title: "예약 메시지 발송 취소"
method: POST
path: "/v2/messages/sms/groups/{groupId}/cancel"
tags: ["SMS"]
---

# 예약 메시지 발송 취소

`POST /v2/messages/sms/groups/{groupId}/cancel`

예약된 문자 메시지의 발송을 취소합니다.

## Path parameters

- `groupId` string, required

## Response `200`

예약 메시지 취소가 성공적으로 처리되었습니다. 취소 요청이 완료되었습니다.

- CancelResponseDto
  - `code` number, required — HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.
  - `message` string, required — API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "성공", 실패 시 구체적인 오류 사유가 포함됩니다.
  - `data` SendCancelMessage, required
    - `groupId` string, required — 취소되거나 즉시 발송된 메시지 그룹의 ID입니다.
    - `succeeded` number — 즉시 발송되거나 예약 취소가 성공적으로 완료된 메시지의 개수입니다.
    - `failed` number — 즉시 발송이나 예약 취소가 실패하거나 불가능한 메시지의 개수입니다.

---

[API](https://skmtc.net/sendon/apis/sendon-api.md) · [All operations](https://skmtc.net/sendon/apis/sendon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sendon/sendon-api/versions/525dedc81a05/schema)