Saltar al contenido principal

Notifications

La API de Notifications te da acceso programático a tu propio feed de notificaciones. Lista notificaciones con paginación por cursor, márcalas como leídas o no leídas, y elimina las que ya no necesitas.

Inicio rápido​

# List your notification feed (cursor pagination)
curl -X GET https://api.copera.ai/public/v1/notifications \
  -H "Authorization: Bearer cp_pat_YOUR_TOKEN"

# Mark a notification as read
curl -X PATCH https://api.copera.ai/public/v1/notifications/NOTIFICATION_ID \
  -H "Authorization: Bearer cp_pat_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "status": "read" }'

# Delete a notification
curl -X DELETE https://api.copera.ai/public/v1/notifications/NOTIFICATION_ID \
  -H "Authorization: Bearer cp_pat_YOUR_TOKEN"

Disponible en​

Public APICLIMCPCopera AI
✅ Completo✅ Completo✅ Completo—

El CLI y el servidor MCP alojado cubren el listado, los cambios de estado y la eliminación. Notifications no está expuesto al asistente Copera AI integrado en la app.

El modelo de notificaciones​

Una notificación pertenece a un solo usuario en un solo workspace. Cada una lleva:

  • type — qué tipo de evento representa.
  • status — READ o UNREAD.
  • data — un payload específico del tipo que describe el evento.
  • sender — quién la desencadenó (cuando aplica), además de readAt y marcas de tiempo.
  • Campos de agrupación — groupCount, groupStartedAt y groupSenderIds para las notificaciones que agrupan varios eventos relacionados.

Listar notificaciones​

Haz un GET al endpoint de notificaciones para recuperar tu feed. Usa paginación por cursor basada en los ids de las notificaciones:

  • after — devuelve notificaciones más recientes que este id.
  • before — devuelve notificaciones más antiguas que este id.

La respuesta incluye el arreglo notifications, el total count y el unreadCount actual:

{
  "notifications": [ /* … */ ],
  "count": 40,
  "unreadCount": 3
}

Consulta Paginación para conocer las convenciones de cursor.

Marcar como leídas o no leídas​

Haz un PATCH a una sola notificación con un status de read o unread:

curl -X PATCH "https://api.copera.ai/public/v1/notifications/{notificationId}" \
  -H "Authorization: Bearer cp_pat_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "status": "read" }'

La respuesta es el objeto de notificación actualizado.

Eliminar una notificación​

Haz un DELETE a una notificación para quitarla de tu feed. La respuesta devuelve el _id de la notificación eliminada.

Autenticación y alcance​

Los endpoints de Notifications requieren un Personal Access Token (cp_pat_) con el alcance access_notifications — siempre operan sobre el feed propio del titular del token. Un token que carezca del alcance recibe un 403. Consulta Autenticación.

Referencia​