보유 전화번호 수정
조직 보유 전화번호의 수정 가능한 메타데이터를 변경합니다. 에이전트 매핑과 SIP 설정은 별도 endpoint에서 관리합니다.
Authorizations
조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.
Path Parameters
조직 보유 전화번호 ID입니다. 전화번호 문자열이 아니라 GET /v3/organization-telephone-numbers 응답의 id를 사용합니다.
Body
전화번호 메타데이터 수정 요청입니다.
전화번호 일반 정보 수정 요청입니다(memo 등).
PATCH 동작 규칙(v3 convention, §2.3):
- 필드를 생략하면 기존 값을 유지합니다.
- 필드에 null을 보내면 해당 값을 삭제합니다(nullable column).
- 빈 body(
{})는 PatchRequest base에서 400으로 거부합니다.
전화번호에 대한 메모. 최대 200자. 필드를 생략하면 기존 값이 유지됩니다. null 전송 시 삭제됩니다.
200Response
성공 응답
조직 보유 전화번호 응답입니다.
전화번호 레코드의 고유 식별자입니다.
등록된 전화번호입니다. 하이픈 없는 숫자 문자열로 반환됩니다.
번호 제공자 구분입니다. 'vox'(vox.ai 구매 번호) 또는 'custom'(자체 보유 번호) 중 하나입니다.
vox, custom 번호의 현재 상태를 나타냅니다. 'active'(사용 중), 'scheduled'(예약됨), 'cancel_requested'(해지 요청됨), 'expired'(만료됨) 중 하나입니다.
active, scheduled, cancel_requested, expired 전화번호 서비스 시작일입니다. unix timestamp (ms).
리소스 생성 시각입니다. unix milliseconds 형식입니다.
리소스 마지막 수정 시각입니다. unix milliseconds 형식입니다.
월 사용료입니다. 단위는 원(KRW)이며, provider가 'custom'인 경우 null일 수 있습니다.
SIP trunk 연동 주소입니다. SIP 설정이 없으면 null입니다.
인바운드 SIP trunk의 고유 식별자입니다. SIP 설정이 없으면 null입니다.
아웃바운드 SIP trunk의 고유 식별자입니다. SIP 설정이 없으면 null입니다.
이 번호에 매핑된 인바운드 에이전트 정보입니다. 매핑이 없으면 null입니다.
이 번호에 매핑된 아웃바운드 에이전트 정보입니다. 매핑이 없으면 null입니다.
문자 수신 에이전트입니다. 미지정이면 null이며 새 AI 채팅을 시작하지 않습니다.
전화번호에 대한 메모입니다. 설정되지 않았으면 null입니다.
전화번호 서비스 종료일입니다. unix timestamp (ms). 해지 예약이 없으면 null입니다.
해지 요청이 접수된 일시입니다. unix timestamp (ms). 해지 요청이 없으면 null입니다.