Suggestions IA

L'endpoint Suggestions renvoie les suggestions d'un projet. Ce que sont les suggestions et d'où elles viennent est expliqué sur la page Suggestions.

---

GET /projects/:id/suggestions

Retourne toutes les suggestions du projet, quel que soit leur statut, de la plus récente à la plus ancienne. L'endpoint n'accepte aucun paramètre de requête : pas de filtre ni de pagination. Il demande une clé avec le scope read.

curl https://app.citeme.io/api/v1/projects/PROJECT_ID/suggestions \
  -H "Authorization: Bearer cm_..."

Réponse (200 OK) :

{
  "data": [
    {
      "id": "6f1c2a8e-3b4d-4e5f-9a0b-1c2d3e4f5a6b",
      "type": "WEBSITE_OPTIMIZATION",
      "title": "Ajouter un bloc FAQ sur la page tarifs",
      "content": "Contenu complet de la suggestion...",
      "status": "PENDING",
      "reasoning": "Pourquoi cette modification aide les moteurs IA à citer la page.",
      "created_at": "2026-09-14T09:12:40.000Z",
      "updated_at": "2026-09-14T09:12:40.000Z"
    }
  ]
}

---

Champs de réponse

Champ	Type	Description
id	UUID	Identifiant de la suggestion
type	chaîne	Type de suggestion, voir ci-dessous
title	chaîne	Titre court
content	chaîne	Contenu prêt à l'emploi
status	chaîne	Statut actuel, voir ci-dessous
reasoning	chaîne ou null	Justification de la suggestion
created_at	date ISO 8601	Date de création
updated_at	date ISO 8601	Date de dernière modification

Valeurs de type

WEBSITE_OPTIMIZATION, BLOG_ARTICLE, LINKEDIN_POST, TWEET, CUSTOM.

Valeurs de status

PENDING, APPROVED, EDITED, REJECTED, PUBLISHED, APPLIED, FAILED, DELETED.

La réponse inclut aussi les suggestions rejetées et supprimées. Filtrez sur status côté client si vous ne voulez que les suggestions actives.

---

Erreurs

Code	Corps	Cause
404	{"error": "Project not found"}	Le projet n'existe pas ou n'appartient pas à votre organisation
500	{"error": "Failed to fetch suggestions"}	Erreur interne

Les erreurs d'authentification et de forfait sont décrites dans Codes d'erreurs.

Valider ou rejeter une suggestion

L'API publique ne fait que lire les suggestions. Pour en valider ou en rejeter une depuis un agent, utilisez le serveur MCP ou la CLI.

---

Mots-clés