Выдать или заменить ключ приложения

curl -X POST https://vibecode.bitrix24.tech/v1/cowork/applications/APPLICATION_ID/key \
  -H "X-Api-Key: YOUR_COWORK_KEY" \
  -H "Idempotency-Key: app-key-2026-09-22-01" \
  -H "Content-Type: application/json" \
  -d '{}'

const res = await fetch('https://vibecode.bitrix24.tech/v1/cowork/applications/APPLICATION_ID/key', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_COWORK_KEY',
    'Idempotency-Key': 'app-key-2026-09-22-01',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
})

if (!res.ok) {
  const { error } = await res.json()
  throw new Error(`${res.status} ${error.code}`)
}

const { data } = await res.json()

// Сырой ключ приходит один раз — сохраните его сразу
if (data.rawApiKey === null) {
  // Это повтор запроса: ключ уже выдан, заново он не показывается
} else {
  saveKey(data.applicationId, data.rawApiKey)
}

// Прежний ключ работает до previousKey.graceUntil — доставьте новый ключ серверу раньше
if (data.previousKey?.graceUntil) {
  console.log('Прежний ключ перестанет работать:', data.previousKey.graceUntil)
}

{
  "success": true,
  "data": {
    "application": {
      "id": "cmud90k3b0009cicg8yxl2rf8",
      "name": "Отчёт по сделкам",
      "description": null,
      "type": "PERSONAL",
      "iconUrl": null,
      "createdAt": "2026-09-22T22:31:23.063Z",
      "updatedAt": "2026-09-22T22:31:23.092Z",
      "viewerState": "owner",
      "pinned": false,
      "author": { "name": "Автор приложений" },
      "isEmbedded": false,
      "openUrl": null,
      "openTarget": null,
      "server": null,
      "sources": { "hasVersions": false, "latestVersionId": null, "latestSavedAt": null },
      "activeOperation": null,
      "key": {
        "slot": "api",
        "present": true,
        "prefix": "vibe_api_…",
        "suffix": "9529",
        "status": "ACTIVE",
        "expiresAt": null,
        "lastUsedAt": null,
        "rotatable": true,
        "rotateBlockedReason": null,
        "affectsShownKey": true
      }
    },
    "applicationId": "cmud90k3b0009cicg8yxl2rf8",
    "issued": "rotated",
    "rawApiKey": "vibe_api_…",
    "key": {
      "id": "b3d37d59-5b50-4e72-aa12-8a2b40a012f8",
      "prefix": "vibe_api_…",
      "suffix": "9529",
      "scopes": ["crm", "vibe:infra", "vibe:storage"],
      "status": "ACTIVE",
      "expiresAt": null,
      "createdAt": "2026-09-22T22:31:23.086Z"
    },
    "previousKey": {
      "id": "5d192322-3ced-438e-bc4f-0cbba01b9937",
      "graceUntil": "2026-09-23T22:31:23.087Z",
      "status": "ACTIVE"
    },
    "envSync": null,
    "warnings": [],
    "warningCodes": []
  }
}

{
  "success": true,
  "data": {
    "application": {
      "id": "cmud90jwg0001cicg4qgipzws",
      "name": "Дашборд продаж",
      "description": null,
      "type": "PERSONAL",
      "iconUrl": null,
      "createdAt": "2026-09-22T22:31:22.816Z",
      "updatedAt": "2026-09-22T22:31:22.889Z",
      "viewerState": "owner",
      "pinned": false,
      "author": { "name": "Автор приложений" },
      "isEmbedded": false,
      "openUrl": null,
      "openTarget": null,
      "server": null,
      "sources": { "hasVersions": false, "latestVersionId": null, "latestSavedAt": null },
      "activeOperation": null,
      "key": {
        "slot": "api",
        "present": true,
        "prefix": "vibe_api_…",
        "suffix": "f08a",
        "status": "ACTIVE",
        "expiresAt": null,
        "lastUsedAt": null,
        "rotatable": true,
        "rotateBlockedReason": null,
        "affectsShownKey": true
      }
    },
    "applicationId": "cmud90jwg0001cicg4qgipzws",
    "issued": "minted",
    "rawApiKey": "vibe_api_…",
    "key": {
      "id": "61a91657-2e88-4aeb-848f-1951327efd71",
      "prefix": "vibe_api_…",
      "suffix": "f08a",
      "scopes": ["vibe:infra", "vibe:storage"],
      "status": "ACTIVE",
      "expiresAt": null,
      "createdAt": "2026-09-22T22:31:22.879Z"
    },
    "previousKey": null,
    "envSync": null,
    "warnings": [],
    "warningCodes": []
  }
}

{
  "success": false,
  "error": {
    "code": "KEY_ROTATE_WIDER_THAN_CALLER",
    "message": "The key in this application slot is wider than your key. Re-issue it from the web cabinet, where the owner sees what the new key will be allowed to do."
  }
}