API de Inbox Autónomo de Kobana
API REST pública para el Inbox Autónomo de Kobana.
Autenticación: Bearer JWT (RS256, emitido por el Authorization Server de Kobana; aud incluye https://api.inbox[.<env>].kobana.com.br) más mTLS terminado en CloudFront (transmitido mediante el header cloudfront-viewer-mtls-client-cert-fingerprint). El claim org del JWT (la cuenta Kobana) resuelve la organización del llamador; sub es la persona y se lleva solo para atribución. Elige un workspace dentro de la organización con X-Workspace-Id cuando haya más de uno.
Los endpoints de recursos {id} (workspaces, inboxes, agents, webhooks) aceptan tanto el UUID interno como el external_id del recurso. Los endpoints POST que poseen un external_id lo aceptan como campo opcional y, si se omite, usan por defecto el id interno generado. El campo deleted_at nunca se devuelve en las respuestas ni en los payloads de webhook; los registros con soft-delete se filtran en su lugar.
Todas las claves en las respuestas y en los payloads de webhook están en snake_case. Las entregas de webhook comparten el serializador de la API: el envelope trae event (slug, id), delivered_at y workspace; data anida snapshots de los recursos (organization, agent, inbox, email, agent_run) más las claves específicas del evento.