Récupérer le changelog personnalisé du workspace

Réponse exemple

{
  "items": [
    {
      "tag": "Vous concerne",
      "body": "Vous appelez régulièrement /v1/webhooks : la nouvelle rotation de secret sans interruption évite toute coupure lors du renouvellement. Pensez à accepter les deux secrets pendant la fenêtre de bascule.",
      "tone": "warn",
      "title": "Rotation du secret de webhook"
    },
    {
      "tag": "Nouveau",
      "body": "Création et partage de Data Rooms désormais exposés via /v1/datarooms, avec gestion fine des viewers.",
      "tone": "violet",
      "title": "Endpoints Data Room M&A"
    },
    {
      "tag": "Amélioration",
      "body": "Les listes volumineuses acceptent maintenant un curseur opaque plus stable sur les exports analytiques.",
      "tone": "ok",
      "title": "Pagination par curseur élargie"
    },
    {
      "tag": "Sans impact",
      "body": "Réorganisation transparente du stockage régional, sans changement d'API.",
      "tone": "info",
      "title": "Migration interne du stockage"
    }
  ],
  "cached": true,
  "object": "personalized_changelog",
  "release": {
    "id": "rel_8f2c1a",
    "name": "API 2026-05 : webhooks signés & Data Room",
    "published_at": "2026-05-14T09:00:00.000Z"
  },
  "fallback": false,
  "expires_at": "2026-06-06T08:12:03.114Z",
  "generated_at": "2026-06-05T08:12:03.114Z"
}

Cet endpoint renvoie le résumé de la dernière release publiée de l'API Coffrify, mais réécrit spécifiquement pour le workspace authentifié. La personnalisation s'appuie sur les endpoints REST et les outils MCP que ce workspace a réellement utilisés sur les 30 derniers jours, ainsi que sur ses actions console récentes : les changements qui touchent vos intégrations sont remontés en priorité (tone:"warn", tag:"Vous concerne"), les autres sont classés en Nouveau, Amélioration ou Sans impact.

Le résultat est mis en cache 24 heures par workspace. Le cache est invalidé automatiquement dès que la signature d'usage change (nouveaux endpoints/outils appelés) ou qu'une nouvelle release est publiée. L'endpoint est fail-safe : si le service IA est indisponible, il renvoie les items génériques de la release avec fallback:true au lieu d'une erreur 500. S'il n'existe aucune release publiée, release vaut null et items est un tableau vide.

Authentification

Requiert une clé API valide, aucun scope spécifique n'est exigé. Présentez la clé via l'en-tête Authorization: Bearer cof_live_... (ou cof_test_..., cof_rk_..., cof_mcp_...). Le workspace ciblé est déduit de la clé : la personnalisation porte toujours sur le workspace propriétaire du jeton.

Paramètres de requête

Cet endpoint n'accepte aucun paramètre de requête ni filtre. Le workspace et la release sont entièrement déterminés côté serveur.

Réponse

La réponse est un objet personalized_changelog. Champs clés : release décrit la release source (id, name, published_at) ou vaut null si aucune release n'est publiée ; items est la liste des entrées personnalisées ; cached indique si la réponse provient du cache 24h ; fallback vaut true quand les items génériques ont été servis faute de personnalisation IA ; generated_at et expires_at bornent la validité du cache (tous deux null quand release est null).

Erreurs

Voir aussi

• GET /v1/welcome : point d'entrée d'introspection de la clé et du workspace.
• GET /v1/webhooks : liste des webhooks, souvent référencés dans les items Vous concerne.
• Documentation des limites de débit : https://docs.coffrify.com/api/rate-limits