하위 조직 삭제 - vox.ai Docs

DELETE

organizations

{organization_id}

하위 조직 삭제

curl --request DELETE \
  --url https://client-api.tryvox.co/v3/organizations/{organization_id} \
  --header 'Authorization: Bearer <token>'

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Request validation failed.",
    "details": {
      "field": "name",
      "reason": "must not be blank"
    }
  }
}

Authorizations

Authorization

string

header

required

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

Path Parameters

organization_id

string

required

삭제할 하위 조직 ID입니다(직속 하위 조직).

Response

성공 응답

조직 인증 신청조직의 인증을 `multipart/form-data`로 신청합니다. 개인사업자·법인(`sole_proprietor`/`corporation`)은 `verification_case`와 사업자등록증(`business_registration`)이 추가로 필요하고, 개인(`personal`)은 `verification_case`를 보내지 않습니다. 신청자(생략 시 조직 오너)는 본인 인증을 마친 조직 멤버여야 합니다. 한 조직에서는 동시에 하나의 인증만 진행할 수 있습니다. 접수되면 202와 함께 인증 기록 `id`(상태 `requested`)를 반환하고, 서류 확인과 승인 처리는 비동기로 진행됩니다 — 결과는 상태 조회로 확인합니다.

하위 조직 삭제

curl --request DELETE \
  --url https://client-api.tryvox.co/v3/organizations/{organization_id} \
  --header 'Authorization: Bearer <token>'

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Request validation failed.",
    "details": {
      "field": "name",
      "reason": "must not be blank"
    }
  }
}