Servers for moving an application

GET /v1/applications/:id/available-servers

Shows where the owner can move the application: which of their own servers fit, and whether a new server can be created. Call it before you show the replace-server screen. The response tells you whether the replace button is needed and, if the replacement is unavailable, gives the reason as a code. The replacement itself is done by POST /v1/applications/:id/replace-server.

Only the card owner can call this method. A Bitrix24 account administrator who does not own the application gets 403 FORBIDDEN, just as with the replacement itself. This way a button that would end in a refusal is never shown.

Authorization: X-Api-Key with the vibe:infra scope.

Parameters

Examples

curl — personal key

curl -H "X-Api-Key: YOUR_API_KEY" \
  https://vibecode.bitrix24.com/v1/applications/cmsw806qi0000tdskiw2aegii/available-servers

curl — OAuth application

curl -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  https://vibecode.bitrix24.com/v1/applications/cmsw806qi0000tdskiw2aegii/available-servers

JavaScript — personal key

const id = 'cmsw806qi0000tdskiw2aegii'
const res = await fetch(`https://vibecode.bitrix24.com/v1/applications/${id}/available-servers`, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
})
const { data } = await res.json()

console.log('Own servers:', data.servers.map((s) => s.name))
if (!data.canCreateNew) {
  console.log('A new server is not available:', data.createNewBlocked.code)
}

JavaScript — OAuth application

const id = 'cmsw806qi0000tdskiw2aegii'
const res = await fetch(`https://vibecode.bitrix24.com/v1/applications/${id}/available-servers`, {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})
const { data } = await res.json()

Response fields

Response example

{
  "success": true,
  "data": {
    "servers": [
      {
        "id": "srv_new",
        "name": "my-server",
        "displayName": null,
        "status": "running",
        "providerId": "bitrix-cloud",
        "plan": "bc-small",
        "region": "bc-eu-central",
        "kind": "STANDALONE",
        "blackholeStatus": null,
        "createdAt": "2026-10-01T09:00:00.000Z"
      }
    ],
    "canCreateNew": true
  }
}

Error response example

403 — the application belongs to someone else, and a Bitrix24 account administrator replaces the server in their Vibecode account:

{
  "success": false,
  "error": {
    "code": "FORBIDDEN",
    "message": "Forbidden"
  }
}

Errors

The error.message text is in English and meant for logs: build interface texts from error.code. The full list of common API errors is in Errors.

Known specifics

• Not all of the owner's servers are listed. A server must belong to the card owner, exist, not be the application's current server, not be linked to another application, not be an agent or bot server and not be a galaxy host. The replacement does not accept a server that is not listed here: POST /v1/applications/:id/replace-server returns 404 SERVER_NOT_FOUND or 409 SERVER_ALREADY_LINKED for it.
• An empty servers array does not block the replacement. The server can also be replaced by creating a new one, if canCreateNew is true. Hide the replace button when the list is empty and canCreateNew is false, and take the reason from createNewBlocked.
• A frozen balance closes creation only. With ACCOUNT_FROZEN in createNewBlocked, moving to your own existing server stays available, and servers is filled by the same rules.
• Creation depends on the account policy. The codes INFRA_NOT_PERMITTED, SERVER_CREATION_DISABLED and SERVER_CREATION_ADMINS_ONLY mean the account policy does not let this person create servers. The replacement in the new form returns the same codes.
• The response is a snapshot at the time of the call. A server may be taken or deleted between this method and the replacement. The replacement rechecks everything itself and returns the matching code.
• The method neither changes nor creates anything. Call it as often as the screen needs.

See also

• Replace an application server
• Application card
• Server list
• Application catalog
• Errors