curl -X POST "https://app.talkover.ai/api/v1/phone-numbers/phone-uuid-1/request-release" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "We migrated outbound calling to a new toll-free number and no longer need this DID."
  }'

await fetch('https://app.talkover.ai/api/v1/phone-numbers/phone-uuid-1/request-release', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer talq_your_environment_token_here',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    reason: 'We migrated outbound calling to a new toll-free number and no longer need this DID.'
  })
});

{
  "success": true,
  "data": {
    "id": "request-uuid-1",
    "phone_number_id": "phone-uuid-1",
    "phone_number": "+15551234567",
    "reason": "We migrated outbound calling to a new toll-free number and no longer need this DID.",
    "status": "pending",
    "requested_at": "2024-01-15T12:00:00Z"
  }
}

{
  "success": false,
  "message": "A release request for this phone number is already pending",
  "code": "RELEASE_ALREADY_PENDING"
}

{
  "success": false,
  "message": "Phone number is currently assigned to active agents and cannot be released",
  "code": "PHONE_NUMBER_IN_USE"
}