Skip to main content
DELETE
/
organization-telephone-numbers
/
{organization_telephone_number_id}
보유 전화번호 해지
curl --request DELETE \
  --url https://client-api.tryvox.co/v3/organization-telephone-numbers/{organization_telephone_number_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "number": "<string>",
  "effective_at": 123
}

Authorizations

​
Authorization
string
header
required

조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Path Parameters

​
organization_telephone_number_id
string<uuid>
required

조직 보유 전화번호 ID입니다. 전화번호 문자열이 아니라 GET /v3/organization-telephone-numbers 응답의 id를 사용합니다.

Response

성공 응답

전화번호 해지 또는 만료 처리 응답입니다.

​
id
string
required

해지 처리된 레코드의 고유 식별자입니다.

​
number
string
required

해지 처리된 전화번호입니다. 하이픈 없는 숫자 문자열로 반환됩니다.

​
provider
enum<string>
required

해지된 번호의 제공자 구분입니다. 'vox'(vox.ai 구매 번호) 또는 'custom'(자체 보유 번호) 중 하나입니다.

Available options:
vox,
custom
​
effective_at
integer
required

해지가 실제로 적용(만료)되는 날짜입니다. unix timestamp (ms). vox 번호는 현재 이용 기간 종료일, custom 번호는 즉시 만료일입니다.