Notificações
Caixa de notificações de quem está autenticado.
Listar notificações
Lista as notificações e mensagens da caixa de entrada de quem chama. Requer a permissão `notifications.inbox.read`. Apenas pessoas autenticadas; chaves de API recebem `403` (`actor_not_allowed`). Listagem paginada no envelope `{items, page}` com `limit`/`cursor` (também aceita `sort`, `q` e `filter`).
Contar notificações não lidas
Retorna, por organização, quantas notificações da caixa de entrada de quem chama ainda não foram lidas. Requer a permissão `notifications.inbox.read`. Apenas pessoas autenticadas; chaves de API recebem `403` (`actor_not_allowed`).
Marcar todas as notificações como lidas
Marca como lidas as notificações da caixa de entrada de quem chama, opcionalmente só de uma `organization_id` ou só da organização atual (`current_only`), e devolve quantas foram marcadas. Requer a permissão `notifications.inbox.manage`. Apenas pessoas autenticadas; chaves de API recebem `403` (`actor_not_allowed`).
Enviar mensagem interna
Envia uma mensagem (`title`, `body`) para outra pessoa ativa da mesma organização, opcionalmente como resposta (`in_reply_to_id`), e devolve `id`, `seq` e `thread_id`. Requer a permissão `notifications.inbox.manage`. Apenas pessoas autenticadas; chaves de API recebem `403` (`actor_not_allowed`). Enviar para si mesmo ou para destinatário inválido retorna `400`.
Buscar destinatários de mensagens
Lista pessoas ativas que podem receber mensagens, com nome e e-mail, filtrando por `q` (até 50 por `limit`). Requer a permissão `notifications.inbox.manage`. Apenas pessoas autenticadas; chaves de API recebem `403` (`actor_not_allowed`).
Melhorar mensagem com IA
Reescreve ou sugere o texto de uma mensagem conforme `mode` (`improve`, `suggest`, `shorten`, `expand`, `formal`, `friendly`, `grammar`, `subject` ou `custom` com `instructions`) e devolve `text` e `model`. Requer a permissão `notifications.inbox.manage`. Apenas pessoas autenticadas; chaves de API recebem `403` (`actor_not_allowed`). IA não configurada retorna `503`, falha do provedor `502`; limite de 30 pedidos a cada 10 minutos (`429`).
Consultar disponibilidade da IA nas mensagens
Informa se há rota de IA utilizável (`configured`) e qual provedor e modelo primários serão usados. Requer a permissão `notifications.inbox.read`. Apenas pessoas autenticadas; chaves de API recebem `403` (`actor_not_allowed`).
Receber notificações em tempo real
Abre um fluxo `text/event-stream` (SSE) de notificações. Não usa cabeçalho de autenticação: exige o `ticket` obtido em `POST /api/v1/notifications/stream-ticket` (ausente ou inválido retorna `401`). Para pessoas, `Last-Event-ID` ou `after` reenvia as notificações com `seq` posterior (até 200).
Consultar notificação
Retorna uma notificação ou mensagem da caixa de quem chama, com remetente, destinatário e conversa. Requer a permissão `notifications.inbox.read`. Apenas pessoas autenticadas; chaves de API recebem `403` (`actor_not_allowed`). `notification_id` é UUID; notificação de outra pessoa retorna `404`.
Criar ticket do fluxo de notificações
Emite um `ticket` de curta duração (`expires_in`, em segundos) vinculado à sessão ou à chave de API, usado para abrir o fluxo em tempo real. Requer a permissão `notifications.inbox.read`. Limite de 30 tickets por minuto (`429`); indisponibilidade temporária retorna `503`.
Marcar notificação como lida
Marca uma notificação da caixa de quem chama como lida e responde `204`. Requer a permissão `notifications.inbox.manage`. Apenas pessoas autenticadas; chaves de API recebem `403` (`actor_not_allowed`). `notification_id` é UUID; notificação de outra pessoa retorna `404`.