curl --request POST \
--url https://api.tungo.kz/v1/workspaces/{ws}/api-keys \
--header 'Content-Type: application/json' \
--cookie tungo.session_token= \
--data '
{
"name": "Интеграция с CRM",
"permissions": [
"company.read",
"chat.use"
],
"company_ids": [
"co_01h455vb4pex5vsknk084sn02q"
],
"all_companies": false,
"expires_at": "2027-01-31T19:00:00Z",
"monthly_cap_tiyn": 500000,
"allowed_ips": [
"203.0.113.10",
"198.51.100.0/24"
],
"write_max_amount_per_document_tiyn": 50000000,
"write_max_amount_per_day_tiyn": 200000000,
"write_kinds": [
"bank_receipt"
]
}
'import requests
url = "https://api.tungo.kz/v1/workspaces/{ws}/api-keys"
payload = {
"name": "Интеграция с CRM",
"permissions": ["company.read", "chat.use"],
"company_ids": ["co_01h455vb4pex5vsknk084sn02q"],
"all_companies": False,
"expires_at": "2027-01-31T19:00:00Z",
"monthly_cap_tiyn": 500000,
"allowed_ips": ["203.0.113.10", "198.51.100.0/24"],
"write_max_amount_per_document_tiyn": 50000000,
"write_max_amount_per_day_tiyn": 200000000,
"write_kinds": ["bank_receipt"]
}
headers = {
"cookie": "tungo.session_token=",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {cookie: 'tungo.session_token=', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Интеграция с CRM',
permissions: ['company.read', 'chat.use'],
company_ids: ['co_01h455vb4pex5vsknk084sn02q'],
all_companies: false,
expires_at: '2027-01-31T19:00:00Z',
monthly_cap_tiyn: 500000,
allowed_ips: ['203.0.113.10', '198.51.100.0/24'],
write_max_amount_per_document_tiyn: 50000000,
write_max_amount_per_day_tiyn: 200000000,
write_kinds: ['bank_receipt']
})
};
fetch('https://api.tungo.kz/v1/workspaces/{ws}/api-keys', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "key_01h455vb4pex5vsknk084sn02q",
"name": "Интеграция с CRM",
"prefix": "tg_ab12cd34ef56",
"workspace_id": "ws_01h455vb4pex5vsknk084sn02q",
"created_by": "<string>",
"company_ids": [
"<string>"
],
"all_companies": true,
"allowed_ips": [
"203.0.113.10",
"198.51.100.0/24"
],
"permissions": [
"company.read"
],
"status": "active",
"expires_at": "2026-10-05T09:30:00.000Z",
"monthly_cap_tiyn": 123,
"write_max_amount_per_document_tiyn": 123,
"write_max_amount_per_day_tiyn": 123,
"write_kinds": [
"<string>"
],
"created_at": "2026-10-05T09:30:00.000Z",
"last_used_at": "2026-10-05T09:30:00.000Z",
"last_used_ip": "203.0.113.10",
"revoked_at": "2026-10-05T09:30:00.000Z",
"disabled_at": "2026-10-05T09:30:00.000Z",
"previous_secret_valid_until": "2026-10-05T09:30:00.000Z",
"key": "tg_ab12cd34ef56_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"warnings": [
{
"code": "platform_balance_empty",
"message": "<string>"
}
],
"key_note": "<string>"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}Выпустить ключ
Ключ целиком (key) — только в этом ответе; повтор по Idempotency-Key вернёт тот же ключ без секрета (key: null, пояснение в key_note). Права ключа — из company.read, chat.use, proposals.create, proposals.approve, automations.manage, automations.read, webhooks.manage; company.read есть всегда; каждое право компании проверяется по правам создателя в каждой компании; automations.read/automations.manage — автоматизации компаний ключа (правило автоодобрения — только с proposals.approve); webhooks.manage — право на вебхуки всей организации, только у ключа на все её компании. Политика организации может запрещать выпуск. warnings — если вызовы ИИ по ключу сейчас не пройдут (например, в тарифе нет доп. использования).
Idempotency-Key: повтор с тем же ключом и тем же телом отдаёт прежний ответ (статус и тело) с заголовком Idempotent-Replayed: true и ничего не делает второй раз; тот же ключ с другим адресом или телом — 422 (error.code = idempotency_key_reused); первый запрос с этим ключом ещё идёт — 409 (error.code = idempotency_in_progress). Запоминается только удачный ответ (2xx): после отказа повтор с тем же ключом выполнится заново. Ключ живёт сутки (настройка idempotency.keys), область — организация и тот, кто прислал (ключ API или человек).
Доступ: Владелец или админ workspace.
Только по сессии кабинета, не по ключу API.
curl --request POST \
--url https://api.tungo.kz/v1/workspaces/{ws}/api-keys \
--header 'Content-Type: application/json' \
--cookie tungo.session_token= \
--data '
{
"name": "Интеграция с CRM",
"permissions": [
"company.read",
"chat.use"
],
"company_ids": [
"co_01h455vb4pex5vsknk084sn02q"
],
"all_companies": false,
"expires_at": "2027-01-31T19:00:00Z",
"monthly_cap_tiyn": 500000,
"allowed_ips": [
"203.0.113.10",
"198.51.100.0/24"
],
"write_max_amount_per_document_tiyn": 50000000,
"write_max_amount_per_day_tiyn": 200000000,
"write_kinds": [
"bank_receipt"
]
}
'import requests
url = "https://api.tungo.kz/v1/workspaces/{ws}/api-keys"
payload = {
"name": "Интеграция с CRM",
"permissions": ["company.read", "chat.use"],
"company_ids": ["co_01h455vb4pex5vsknk084sn02q"],
"all_companies": False,
"expires_at": "2027-01-31T19:00:00Z",
"monthly_cap_tiyn": 500000,
"allowed_ips": ["203.0.113.10", "198.51.100.0/24"],
"write_max_amount_per_document_tiyn": 50000000,
"write_max_amount_per_day_tiyn": 200000000,
"write_kinds": ["bank_receipt"]
}
headers = {
"cookie": "tungo.session_token=",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {cookie: 'tungo.session_token=', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Интеграция с CRM',
permissions: ['company.read', 'chat.use'],
company_ids: ['co_01h455vb4pex5vsknk084sn02q'],
all_companies: false,
expires_at: '2027-01-31T19:00:00Z',
monthly_cap_tiyn: 500000,
allowed_ips: ['203.0.113.10', '198.51.100.0/24'],
write_max_amount_per_document_tiyn: 50000000,
write_max_amount_per_day_tiyn: 200000000,
write_kinds: ['bank_receipt']
})
};
fetch('https://api.tungo.kz/v1/workspaces/{ws}/api-keys', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "key_01h455vb4pex5vsknk084sn02q",
"name": "Интеграция с CRM",
"prefix": "tg_ab12cd34ef56",
"workspace_id": "ws_01h455vb4pex5vsknk084sn02q",
"created_by": "<string>",
"company_ids": [
"<string>"
],
"all_companies": true,
"allowed_ips": [
"203.0.113.10",
"198.51.100.0/24"
],
"permissions": [
"company.read"
],
"status": "active",
"expires_at": "2026-10-05T09:30:00.000Z",
"monthly_cap_tiyn": 123,
"write_max_amount_per_document_tiyn": 123,
"write_max_amount_per_day_tiyn": 123,
"write_kinds": [
"<string>"
],
"created_at": "2026-10-05T09:30:00.000Z",
"last_used_at": "2026-10-05T09:30:00.000Z",
"last_used_ip": "203.0.113.10",
"revoked_at": "2026-10-05T09:30:00.000Z",
"disabled_at": "2026-10-05T09:30:00.000Z",
"previous_secret_valid_until": "2026-10-05T09:30:00.000Z",
"key": "tg_ab12cd34ef56_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"warnings": [
{
"code": "platform_balance_empty",
"message": "<string>"
}
],
"key_note": "<string>"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}Авторизации
Сессия кабинета: cookie ставит вход через /v1/auth/* (Better Auth), браузер шлёт её сам — фронтенду кабинета ничего добавлять не нужно (fetch с credentials: 'include'). За HTTPS имя cookie — __Secure-tungo.session_token. Сессия кончилась — 401 authentication_error: отправить на вход.
Заголовки
Ключ повтора (например, UUID): повтор с тем же ключом и тем же телом не выполняет действие второй раз, а отдаёт прежний ответ
255Параметры пути
id организации (workspace), ws_… — из GET /v1/workspaces
Тело
Новый ключ API.
Название ключа для людей (1–100 знаков): где он используется
1 - 100"Интеграция с CRM"
Права ключа (1–20): company.read — читать данные компаний (добавляется всегда, даже если не передано); chat.use — работать с ИИ-бухгалтером; proposals.create — готовить документы для 1С; proposals.approve — одобрять запись документов в 1С; automations.read — видеть хуки, сценарии и журнал запусков; automations.manage — менять и запускать автоматизации; webhooks.manage — вебхуки всей организации (только у ключа на все её компании). Ни одно право не шире прав создателя
1 - 20 elements["company.read", "chat.use"]
Компании, к которым ключ даёт доступ (co_…), от 1 до 200; все — из этой организации, и в каждой у создателя должны быть выдаваемые права. Для webhooks.manage — обязательно все компании организации. Обязательно, если не all_companies
1 - 200 elements["co_01h455vb4pex5vsknk084sn02q"]
Ключ на все компании организации, в том числе будущие: список company_ids не передаётся. Ключ видит те компании, где его создатель состоит сейчас, и в каждой — не шире его текущей роли. По умолчанию false
false
Когда ключ перестанет действовать, ISO 8601; только в будущем и не дальше настройки платформы (по умолчанию 365 дней). null или нет — через срок по умолчанию (90 дней)
"2027-01-31T19:00:00Z"
Месячный потолок расхода ИИ по ключу в тиынах (1 ₸ = 100 тиын), календарный месяц по Алматы; дойдя до него, вызовы ИИ по ключу отклоняются до 1-го числа. null — без потолка ключа
x >= 0500000
С каких адресов ключ работает: IP или подсети CIDR (до 100), IPv4 и IPv6. С другого адреса — 403, error.code ip_not_allowed. null — с любых
1 - 100 elements64["203.0.113.10", "198.51.100.0/24"]
Предел записи в 1С по ключу: потолок суммы одного документа, который ключ одобряет (approve, approve-batch), в тиынах (1 ₸ = 100 тиын). Документ дороже или без известной суммы ключ не запишет (403, error.code key_write_limit) — его запишет человек. null — без предела. При изменении: не передан — не меняется; снять или поднять — только создатель ключа
50000000
Предел записи в 1С по ключу: сумма всех документов, одобренных ключом за день по Алматы, в тиынах. Документ с неизвестным исходом записи (1С не ответила) тоже считается. null — без предела. При изменении: не передан — не меняется; снять или поднять — только создатель ключа
200000000
Предел записи в 1С по ключу: какие виды документов ключ может одобрять (как kinds правила автоодобрения: sale, purchase, bank_receipt, bank_payment, counterparty, contract, inventory_writeoff, cash_order_in, cash_order_out, advance_report, revert). null — любые. Без всех трёх пределов ключ с proposals.approve пишет в 1С без ограничений — тогда в ответе предупреждение write_unlimited. При изменении: не передан — не меняется; снять или добавить вид — только создатель ключа
1 - 20 elementssale, purchase, bank_receipt, bank_payment, counterparty, contract, inventory_writeoff, cash_order_in, cash_order_out, advance_report, revert ["bank_receipt"]
Ответ
Выпущен
Выпущенный ключ — с секретом один раз.
id ключа (key_…) — для адресов …/api-keys/{id}
"key_01h455vb4pex5vsknk084sn02q"
Название ключа для людей
"Интеграция с CRM"
Открытая часть ключа для показа — узнать ключ среди других; сам ключ (tg_…_секрет) целиком не хранится
"tg_ab12cd34ef56"
Организация ключа (ws_…)
"ws_01h455vb4pex5vsknk084sn02q"
Кто выпустил (usr_…). Ключ действует от его имени и не шире его прав: создатель перестал быть владельцем или админом — ключ не работает
Компании, к которым ключ даёт доступ (co_…); пусто у ключа на все компании (all_companies)
Ключ на все компании организации, в том числе будущие: те, где создатель ключа состоит сейчас, и в каждой — не шире его текущей роли
С каких IP и подсетей CIDR ключ работает; с другого адреса — 403 ip_not_allowed. null — с любых
["203.0.113.10", "198.51.100.0/24"]
Права ключа: company.read — читать данные компаний (есть всегда); chat.use — работать с ИИ-бухгалтером; proposals.create — готовить документы для 1С; proposals.approve — одобрять запись в 1С; automations.read — видеть автоматизации; automations.manage — менять и запускать автоматизации; webhooks.manage — вебхуки всей организации
company.read, chat.use, proposals.create, proposals.approve, automations.manage, automations.read, webhooks.manage Состояние: active — действует; disabled — выключен (disabled_at), не работает, можно включить; expired — истёк срок (expires_at), не работает; revoked — отозван (revoked_at), не работает. Неактивные показывать серыми
active, disabled, expired, revoked Когда ключ перестаёт действовать, ISO 8601 UTC (срок есть у каждого ключа)
"2026-10-05T09:30:00.000Z"
Месячный потолок расхода ИИ по ключу в тиынах (1 ₸ = 100 тиын; показывать значение / 100 ₸), календарный месяц по Алматы; null — без потолка ключа
Предел записи в 1С по ключу: потолок суммы одного документа, который ключ одобряет (approve, approve-batch), в тиынах (1 ₸ = 100 тиын). Документ дороже или без известной суммы ключ не запишет (403, error.code key_write_limit) — его запишет человек. null — без предела
Предел записи в 1С по ключу: сумма всех документов, одобренных ключом за день по Алматы, в тиынах. Документ с неизвестным исходом записи (1С не ответила) тоже считается. null — без предела
Предел записи в 1С по ключу: какие виды документов ключ может одобрять (как kinds правила автоодобрения: sale, purchase, bank_receipt, bank_payment, counterparty, contract, inventory_writeoff, cash_order_in, cash_order_out, advance_report, revert). null — любые. Без всех трёх пределов ключ с proposals.approve пишет в 1С без ограничений — тогда в ответе предупреждение write_unlimited
Когда выпущен, ISO 8601 UTC
"2026-10-05T09:30:00.000Z"
Когда ключом пользовались последний раз, ISO 8601 UTC (точность — около минуты); null — ещё ни разу
"2026-10-05T09:30:00.000Z"
С какого IP-адреса был последний запрос; null — ещё ни разу
"203.0.113.10"
Когда отозван, ISO 8601 UTC; null — не отозван
"2026-10-05T09:30:00.000Z"
Когда выключен, ISO 8601 UTC; null — не выключен
"2026-10-05T09:30:00.000Z"
После смены секрета (roll): до какого времени ещё действует прежний, ISO 8601 UTC; null — прежнего нет
"2026-10-05T09:30:00.000Z"
Ключ целиком (tg_…) — только в этом ответе: показать один раз с кнопкой «Скопировать» и предупреждением, что больше его не увидеть. В повторе по Idempotency-Key — null
"tg_ab12cd34ef56_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
Ключ сохранён, но вызовы ИИ по нему сейчас не пройдут или он пишет в 1С без пределов: баланс платформы пуст (402 platform_balance_exhausted), подключение компании не оплачено (402 onboarding_unpaid), потолок ключа меньше оценки вызова (402 key_cap_reached). Пустой список — всё в порядке.
Show child attributes
Show child attributes
Только в повторе по Idempotency-Key: почему key = null и что делать, если ключ потерян (отозвать и выпустить новый)