API do Inbox Autônomo Kobana
API REST pública do Inbox Autônomo Kobana.
Autenticação: Bearer JWT (RS256, emitido pelo Authorization Server da Kobana; aud inclui https://api.inbox[.<env>].kobana.com.br) somado a mTLS terminado no CloudFront (repassado como o header cloudfront-viewer-mtls-client-cert-fingerprint). O claim org do JWT (a conta Kobana) resolve a organização do chamador; sub é a pessoa e é carregado só para atribuição. Escolha um workspace dentro da organização com X-Workspace-Id quando houver mais de um.
Os endpoints de recurso {id} (workspaces, inboxes, agents, webhooks) aceitam tanto o UUID interno quanto o external_id do recurso. Endpoints POST que possuem external_id o aceitam como campo opcional, usando por padrão o id interno gerado quando omitido. O campo deleted_at nunca é retornado nas respostas nem nos payloads de webhook; registros com soft-delete são filtrados em vez disso.
Todas as chaves nas respostas e nos payloads de webhook estão em snake_case. As entregas de webhook compartilham o serializador da API: o envelope traz event (slug, id), delivered_at e workspace; data aninha snapshots dos recursos (organization, agent, inbox, email, agent_run) mais as chaves específicas do evento.