For AI agents: markdown of this page — /docs-content-en/apps/delete.md documentation index — /llms.txt

Delete an application

DELETE /v1/apps/:id

Deletes the application and revokes the paired API key. This is a soft delete: the application is hidden from the list, the catalog, and the Bitrix24 account handler; it cannot be restored via the API — create a new one if needed.

Parameters

Parameter Type Required Description
id (path) string yes Application identifier from create or list

No request body is required — an empty body is allowed.

Examples

curl — personal key

Terminal 
curl -X DELETE https://vibecode.bitrix24.com/v1/apps/APP_ID \
  -H "X-Api-Key: YOUR_API_KEY"

curl — OAuth application

Terminal 
curl -X DELETE https://vibecode.bitrix24.com/v1/apps/APP_ID \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

JavaScript — personal key

javascript 
const res = await fetch('https://vibecode.bitrix24.com/v1/apps/APP_ID', {
  method: 'DELETE',
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
})
if (res.status === 204) {
  console.log('Deleted')
}

JavaScript — OAuth application

javascript 
const res = await fetch('https://vibecode.bitrix24.com/v1/apps/APP_ID', {
  method: 'DELETE',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

Response

On successful deletion, the API returns HTTP status 204 No Content with an empty body. The success indicator is the response code, not the content.

Response example

204 No Content (no body)

Error response example

409 — the paired key still owns active servers:

JSON 
{
  "success": false,
  "error": {
    "code": "APP_HAS_ACTIVE_SERVERS",
    "message": "App key has active servers — rebind them first",
    "details": {
      "activeServerCount": 2,
      "userMessage": "This key manages 2 servers. Rebind them to another key before deleting.",
      "servers": [
        { "id": "srv-1", "name": "app-abc12345" }
      ]
    }
  }
}

Errors

HTTP Code Description
403 INFRA_FORBIDDEN_FOR_COWORK_KEY The call was made with a Cowork/Code key — such a key works with data only and cannot perform write operations. To issue a key that can, see Project key for deploy
403 UNAUTHORIZED The call was made with an authorization key vibe_app_… issued for a different application. Such a key deletes only its own application, even when both applications were created by the same author
403 UNAUTHORIZED The key does not belong to the author or owner of the application
404 APP_NOT_FOUND No application with the specified id. Repeated deletion of the same id also returns this code
409 APP_HAS_ACTIVE_SERVERS The paired key still owns active servers — rebind them to another key first. details carries activeServerCount, userMessage, servers

Full list of common API errors — Errors.

Known specifics

  • Repeated deletion is idempotent. A second DELETE of the same id returns 404 APP_NOT_FOUND — the application is already hidden by the soft delete. This is a normal response, not a failure: repeating the call is safe.

See also