API

그룹 메시지 삭제

작성일 2026.03.05 | 수정일 2026.08.17

DELETE/messages/v4/groups/:groupId/messages

Parameters

groupId*— 메시지를 삭제할 그룹의 아이디

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

DELETE/messages/v4/groups/fast/:groupId/messages

Parameters

groupId*— 메시지를 삭제할 그룹의 아이디

고속 접수 그룹에서 잘못 추가한 메시지를 발송 전에 삭제합니다. 요청과 응답 형식은 기존 그룹 메시지 삭제 API와 동일합니다.

Body Params

Name	Type	Required	Description
messageIds	array	*	삭제할 메시지 아이디 배열. M4V로 시작하는 32자 문자열. 최소 1건 이상 필요

Response

Name	Type	must	Description
groupId	string	*	그룹 아이디
errorCount	number	*	삭제에 실패한 건수. 존재하지 않는 메시지 아이디를 전달한 경우 증가
resultList	array	*	각 메시지의 삭제 결과 목록
messageId	string	*	삭제 요청한 메시지 아이디
resultCode	string	*	삭제 결과. Success(성공) 또는 ResourceNotFound(해당 메시지를 찾을 수 없음)

Structure

Request

{
  "messageIds": [
    "M4V20260302143506CQKNPHTPCX4P5E",
    "M4V20260302143506DRLMPITQDX5Q6F"
  ]
}

Response

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