API de Notificações
3 endpoints · base https://api.comando.one/v1 · autenticação por chave cmd_live_…
GET
/notificationsListar notificações
notifications:read
Parâmetros, corpo, resposta e exemplo
Parâmetros
page(query) | integer | Número da página (default: 1) |
per_page(query) | integer | Itens por página (default: 20, máx: 100) |
type(query) | string | Tipo da notificação. |
entity_type(query) | string | Entidade relacionada. |
entity_id(query) | string (uuid) | Id da entidade relacionada. |
user_id(query) | string (uuid) | Destinatário. |
created_from(query) | string (date) | Criadas a partir de. |
created_to(query) | string (date) | Criadas até. |
Resposta 200 — Listagem paginada
id | string (uuid) | |
user_id | string (uuid) | |
type | string | |
title | string | |
body | string | |
entity_type | string | |
entity_id | string (uuid) | |
read_at | string (date-time) | |
created_at | string (date-time) |
Exemplo
curl -X GET "https://api.comando.one/v1/notifications" \
-H "Authorization: Bearer cmd_live_SUA_CHAVE"GET
/notifications/{id}Obter notificação
notifications:read
Parâmetros, corpo, resposta e exemplo
Parâmetros
idobrigatório(path) | string (uuid) |
Resposta 200 — Notificação
id | string (uuid) | |
user_id | string (uuid) | |
type | string | |
title | string | |
body | string | |
entity_type | string | |
entity_id | string (uuid) | |
read_at | string (date-time) | |
created_at | string (date-time) |
Exemplo
curl -X GET "https://api.comando.one/v1/notifications/{id}" \
-H "Authorization: Bearer cmd_live_SUA_CHAVE"PATCH
/notifications/{id}/readMarcar notificação como lida
notifications:update
Parâmetros, corpo, resposta e exemplo
Parâmetros
idobrigatório(path) | string (uuid) |
Corpo (JSON)
read | boolean | `false` marca como NÃO lida. |
Resposta 200 — Notificação atualizada
id | string (uuid) | |
user_id | string (uuid) | |
type | string | |
title | string | |
body | string | |
entity_type | string | |
entity_id | string (uuid) | |
read_at | string (date-time) | |
created_at | string (date-time) |
Exemplo
curl -X PATCH "https://api.comando.one/v1/notifications/{id}/read" \
-H "Authorization: Bearer cmd_live_SUA_CHAVE"Início rápido, autenticação, SDK, servidor MCP e o playground para testar sem escrever código estão na documentação completa. A especificação em OpenAPI está em api.comando.one/openapi.json.
Outros recursos da API
Ou deixe a IA usar a API por você
O servidor MCP expõe estes mesmos recursos ao ChatGPT, Claude ou Gemini — com OAuth, sem chave de API.
Conectar um assistente