Delete an application
Permanently removes an application from your workspace.
Details
| Description | Deletes one application owned by the API key's workspace. Returns an empty body on success. |
|---|---|
| HTTP Method | DELETE |
| Endpoint URL | /v1/applications/:id |
| Authorization | API key as a bearer token — Authorization: Bearer $VOYLO_API_KEY. The application must belong to the key's workspace, otherwise 404. See Authentication. |
Request parameters
| Parameter | Description | Location | Constraints | Default |
|---|---|---|---|---|
id | The application's id. | Path | uuid (required) | — |
Request example
cURL
curl -X DELETE \ https://voylo.ai/v1/applications/8f3b1c2e-9a4d-4e7f-8b21-6c5d4e3f2a1b \ -H "Authorization: Bearer $VOYLO_API_KEY"
Success response
204 No Content — the response body is empty.
Possible errors
| Error | Description |
|---|---|
| 400 Bad Request | id is not a valid UUID. |
| 401 Unauthorized | API key is missing, invalid, or revoked. |
| 403 Forbidden | The key's role doesn't permit this action. |
| 404 Not Found | No application with that id in the key's workspace (also returned for applications owned by another workspace). |
Irreversible
Deleting an application doesn't detach it from numbers automatically — point any number using it at another application first, or inbound calls to that number will have no call-control logic to run.