Cowork/Code subscription

Cowork/Code is a single subscription: the desktop app, Code mode, and autonomous agents share one AI quota. The endpoints in this section report the current subscription state — the tier, quota usage across three windows as a percentage, and advice on when to wait for a reset or move to a higher tier. The subscription covers AI only, and only while it is connected and active: the agent's own server is paid for separately, from the account wallet. Beyond reading state, the section issues a project key with deploy rights and creates a personal application together with its key.

Scope: vibe:cowork | Base URL: https://vibecode.bitrix24.com/v1 | Authorization: X-Api-Key

Three quota windows | Tiers | How to start | Quick start | Full example | Endpoint reference | Error codes | Your own agent

What Cowork/Code is

One subscription gives one quota for AI requests — three tools spend it from a shared balance:

• Cowork — a desktop app with an AI assistant for working with a Bitrix24 account.
• Code — a mode for writing and publishing applications inside the desktop app.
• AI Agent — autonomous AI agents.

The quota covers AI only, and only while the subscription is connected and active. The agent's own server is paid for separately, from the account wallet.

Advantages of a single subscription:

• A shared balance across three tools instead of separate limits.
• The free tier is active immediately — no payment is required to start.
• Usage is shown as a percentage, with no overage — the limit is predictable.
• Scales through the ×1 → ×5 → ×20 tiers as your workload grows.

As long as the subscription is connected and active, agents and Code mode spend its quota automatically — nothing needs to be configured separately. The AI agent's own server, however, is paid for from the account wallet and is not included in the subscription quota.

Disabling Cowork/Code at the platform level does not change AI billing for an already-issued vibe:cowork key: chat and audio transcription continue to use the active subscription quota. Audio also requires an administrator-configured per-minute or per-call price for a model available to you. Without an active subscription, audio retains its standard billing path without drawing on subscription quota.

Three quota windows

Quota usage is counted simultaneously in three nested windows:

Work is blocked when any of the windows is exhausted. Each window has a usage percentage and a reset time. Absolute quota numbers are not exposed — both /v1/cowork/state and /v1/cowork/me show percentages only.

Tiers

The ×N multiplier sets the quota volume across all three windows relative to the Pro tier (×1). Each tier's price is returned separately, in the feeVibes field (in Vibe credits per month), and is current as of the time of the request.

How to start

1. Open the Cowork/Code section in your Vibecode account.
2. The free tier is active immediately — the quota is available without connecting anything.
3. If you need more quota, pick the Pro, Max, or Ultra tier.
4. To call the endpoints in this section, use an authorization key with the vibe:cowork scope — pass it in the X-Api-Key header.
5. Agents and Code mode use this subscription's quota automatically, as long as it is connected and active.

More on keys and scopes — Keys and authorization.

Quick start

The current subscription state in a single request:

curl https://vibecode.bitrix24.com/v1/cowork/state \
  -H "X-Api-Key: YOUR_API_KEY"

{
  "subscription": { "tier": "FREE", "state": "ACTIVE", "nextChargeAt": null, "cancelAtPeriodEnd": false },
  "windows": {
    "fiveHour": { "pctUsed": 40, "resetAt": "2026-06-09T17:30:00.000Z", "exhausted": false },
    "week":     { "pctUsed": 24, "resetAt": "2026-06-12T09:00:00.000Z", "exhausted": false },
    "month":    { "pctUsed": 20, "resetAt": "2026-07-01T00:00:00.000Z", "exhausted": false }
  },
  "bottleneck": "fiveHour",
  "recommendation": { "reason": "none", "upgrade": { "available": true, "nextTier": "PRO" } }
}

Full example: tracking the quota

The script polls the subscription state and reacts when the limit is approaching and when the quota is exhausted.

const BASE = 'https://vibecode.bitrix24.com/v1'
const API_KEY = process.env.VIBE_KEY

async function checkQuota() {
  const res = await fetch(`${BASE}/cowork/state`, {
    headers: { 'X-Api-Key': API_KEY },
  })

  if (!res.ok) {
    const { error } = await res.json()
    console.error('Cowork/Code:', error.code, error.message)
    return
  }

  const state = await res.json()
  const { windows, bottleneck, recommendation } = state

  // The busiest window
  const tight = windows[bottleneck]
  console.log(`Window ${bottleneck}: ${tight.pctUsed}%`)

  // Quota exhausted — show when work can resume
  if (recommendation.wait) {
    const seconds = Math.ceil((new Date(recommendation.wait.resetAt) - new Date(state.serverTime)) / 1000)
    console.log(`Limit exhausted, reset in ${seconds} s`)
  }

  // Approaching the limit — suggest a higher tier
  if (recommendation.reason === 'approaching' && recommendation.upgrade.nextTier) {
    console.log(`Consider moving to the ${recommendation.upgrade.nextTier} tier`)
  }
}

// Poll once every 30 seconds
setInterval(checkQuota, 30_000)
checkQuota()

Endpoint reference

An interactive method switcher with examples and response fields — Endpoints.

Error codes

The full list of common API errors — Errors.

See also

• Endpoints
• Off-peak hours in the Cowork/Code subscription
• Keys and authorization
• Limits and optimization
• Errors