Update & Delete

Two write operations: patch fields on an existing Application, or delete it.

Update

Patches are partial — only the fields you submit are changed. Pass empty strings to clear a URL field.

Endpoint

PATCH https://api.tryvox.io/v1/voice/applications/{id}

Request body

All fields are optional. The API only updates the keys present in the body — omitted keys keep their current values.

Example request

curl -X PATCH https://api.tryvox.io/v1/voice/applications/app_8f7a4b2e91c24f3d9a1e2c4b6d8f0a1c \
  -u $TRYVOX_AUTH_ID:$TRYVOX_AUTH_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "voice_url": "https://your-app.com/v2/answer",
    "fallback_url": "https://your-app.com/v2/fallback"
  }'

Response

200 OK — the full updated Application:

{
  "id": "app_8f7a4b2e91c24f3d9a1e2c4b6d8f0a1c",
  "account_id": "TJab12cd34",
  "name": "Main IVR",
  "answer_url": "https://your-app.com/v2/answer",
  "answer_method": "POST",
  "fallback_url": "https://your-app.com/v2/fallback",
  "hangup_url": "https://your-app.com/hangup",
  "status": "active",
  "created_at": "2026-04-09T10:30:00Z",
  "updated_at": "2026-04-09T11:14:32Z"
}

The change applies immediately. Calls in progress that already fetched VoxML keep their old behaviour; the next inbound call uses the new URLs.

Errors

Delete

Endpoint

DELETE https://api.tryvox.io/v1/voice/applications/{id}

Example request

curl -X DELETE \
  -u $TRYVOX_AUTH_ID:$TRYVOX_AUTH_TOKEN \
  https://api.tryvox.io/v1/voice/applications/app_8f7a4b2e91c24f3d9a1e2c4b6d8f0a1c

Response

204 No Content.

What happens to attached resources

• Phone numbers that pointed at the deleted Application keep their application_id reference, but inbound routing looks up the Application at call time and falls into the fallback_url or hangs up if there is none.
• SIP endpoints behave the same way — outgoing calls placed by the endpoint will fail their VoxML fetch.

Re-attach a different Application (or set inline URLs) on each affected resource before deleting if you want continuity. There is no soft-delete or undo.

Errors