API

그룹 메시지 삭제

작성일 2026.03.05 | 수정일 2026.03.05

DELETE/messages/v4/groups/:groupId/messages
Parameters
groupId*— 메시지를 삭제할 그룹의 아이디

그룹에서 특정 메시지를 삭제합니다. 잘못 추가한 메시지를 발송 전에 제거할 때 사용합니다.
PENDING 상태인 그룹의 메시지만 삭제할 수 있습니다.

Body Params

NameTypeRequiredDescription
messageIdsarray*삭제할 메시지 아이디 배열. M4V로 시작하는 32자 문자열. 최소 1건 이상 필요

Response

NameTypeRequiredDescription
groupIdstring*그룹 아이디
errorCountnumber*삭제에 실패한 건수. 존재하지 않는 메시지 아이디를 전달한 경우 증가
resultListarray*각 메시지의 삭제 결과 목록
messageIdstring*삭제 요청한 메시지 아이디
resultCodestring*삭제 결과. Success(성공) 또는 ResourceNotFound(해당 메시지를 찾을 수 없음)

Structure

Request
{ "messageIds": [ "M4V20260302143506CQKNPHTPCX4P5E", "M4V20260302143506DRLMPITQDX5Q6F" ] }
Response
{ "groupId": "G4V20260302143025ABCDEFGHIJKLMNO", "errorCount": 0, "resultList": [ { "messageId": "M4V20260302143506CQKNPHTPCX4P5E", "resultCode": "Success" }, { "messageId": "M4V20260302143506DRLMPITQDX5Q6F", "resultCode": "Success" } ] }