Aller au contenu principal

Notifications

L'API Notifications vous donne un accès programmatique à votre propre flux de notifications. Listez les notifications avec pagination par curseur, marquez-les lues ou non lues, et supprimez celles dont vous n'avez plus besoin.

Démarrage rapide​

# 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 dans​

Public APICLIMCPCopera AI
✅ Complet✅ Complet✅ Complet—

La CLI et le serveur MCP hébergé couvrent le listage, les changements de statut et la suppression. Les notifications ne sont pas exposées à l'assistant Copera AI intégré à l'app.

Le modèle de notification​

Une notification appartient à un seul utilisateur dans un seul workspace. Chacune porte :

  • type — le type d'événement qu'elle représente.
  • status — READ ou UNREAD.
  • data — une charge utile spécifique au type décrivant l'événement.
  • sender — qui l'a déclenchée (le cas échéant), plus readAt et des horodatages.
  • Champs de regroupement — groupCount, groupStartedAt et groupSenderIds pour les notifications qui regroupent plusieurs événements liés.

Lister les notifications​

GET l'endpoint des notifications pour récupérer votre flux. Il utilise la pagination par curseur basée sur les ids de notification :

  • after — renvoyer les notifications plus récentes que cet id.
  • before — renvoyer les notifications plus anciennes que cet id.

La réponse inclut le tableau notifications, le count total, et le unreadCount actuel :

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

Voir Pagination pour les conventions de curseur.

Marquer lu ou non lu​

PATCH une notification unique avec un status de read ou 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 réponse est l'objet notification mis à jour.

Supprimer une notification​

DELETE une notification pour la retirer de votre flux. La réponse renvoie le _id de la notification supprimée.

Authentification et scope​

Les endpoints de notifications exigent un Personal Access Token (cp_pat_) avec le scope access_notifications — ils opèrent toujours sur le propre flux du détenteur du token. Un token sans ce scope obtient un 403. Voir Authentification.

Référence​