수신 통화 차단 등록
번호를 수신 통화 차단 목록에 등록합니다. 등록 즉시 그 번호에서 이 계정의 모든 번호로 걸려 오는
수신 통화가 받지 않고 거절됩니다. 거절된 통화는 통화 기록에 status=rejected,
hangupCause=caller_blocked 로 남습니다.
대상은 수신 통화뿐입니다. 이 계정에서 그 번호로 거는 발신은 막지 않습니다 — 발신을 막으려면 수신거부 등록을 사용하세요.
번호 표시제한 통화(발신 번호가 없는 통화)는 이 목록으로 막을 수 없습니다. 번호 설정
(번호 설정 수정)의 rejectCallerIdRestricted 를 켜세요.
멱등입니다. 이미 차단 중인 번호를 다시 등록하면 에러 없이 기존 항목을 200 으로 돌려줍니다.
새로 등록된 경우에만 201 입니다.
차단 중인 항목은 계정당 10,000건까지 등록할 수 있습니다. 넘으면 422 blocked_caller_limit_exceeded 입니다.
Authentication
API Key를 Bearer 토큰으로 전달
Path parameters
계정 ID
Request
차단할 발신 번호. 국내 번호만 받으며 하이픈·+82 모두 허용합니다(국내 표기로 정규화되어 저장). anonymous 처럼 번호가 아닌 값은 400 입니다.
자유 메모
Response
이미 차단 중 — 기존 항목을 그대로 반환(멱등)
수신 통화 차단 항목 id
차단한 발신 번호. 하이픈·+82 로 보내도 국내 표기로 정규화되어 저장됩니다. 이 번호에서 걸려 온 수신 통화는 받지 않고 거절됩니다.
지금 차단 중인지 여부. 해제된 항목도 이력으로 남아 조회되므로 이 값으로 구분합니다.
등록 경로. console=콘솔, api=REST API, mcp=MCP 도구.
자유 메모
등록 주체(콘솔 사용자 등). API 키로 등록하면 null 입니다.
차단 등록 시각
해제 시각. null 이면 차단 중입니다. 해제해도 항목은 삭제되지 않고 이력으로 남습니다.
해제 경로(source 와 같은 값 집합)
해제 주체. API 키로 해제하면 null 입니다.
해제 사유 메모