# Suggestions IA

> Endpoint API pour lire les suggestions d'un projet, avec la forme exacte de la réponse, les types et les statuts.

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](../plateforme/suggestions.md).

---

## `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`.

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

**Réponse (200 OK) :**

```json
{
  "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](./errors.md).

:::tip 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](../mcp/index.md) ou la [CLI](../cli/index.md).
:::

---

**[Mots-clés](./keywords.md)**