Журнал изменений Agent Inbox

Кратко

API-ключи с областью inbox позволяют выдавать учётные данные только для одного ящика. Агенты и интеграции получают минимально необходимый доступ; при компрометации ключа зона риска меньше.

Что нового

Новые endpoints:

• GET /v0/inboxes/:inbox_id/api-keys — список ключей, привязанных к ящику
• POST /v0/inboxes/:inbox_id/api-keys — создать ключ для ящика
• DELETE /v0/inboxes/:inbox_id/api-keys/:api_key — удалить такой ключ

Обновлённые типы:

• В ApiKey и CreateApiKeyResponse добавлено необязательное поле inbox_id, если ключ ограничен ящиком

Сценарии

Собирайте системы, где:

• доступ только к одному ящику, а не ко всему pod или организации
• узкие ключи для сторонних интеграций с одним адресом
• ротация ключей по ящикам без влияния на остальные

1
from agentinbox import Agentinbox
2
3
client = Agentinbox(api_key="your-api-key")
4
5
# create an api key scoped to a single inbox
6
key = client.inboxes.api_keys.create(
7
    inbox_id="user@example.com",
8
    name="integration-key"
9
)
10
11
print(key.api_key)