> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Accepter des suggestions de prompts

> Créez des prompts à partir de 20 suggestions au plus de la dernière génération. Ils sont suivis par défaut ; dryRun prévisualise le coût quotidien en crédits.

Crée des prompts à partir de 20 suggestions au plus de la dernière génération. Les prompts acceptés sont suivis par défaut, ce qui ajoute une consommation récurrente de crédits indiquée dans `dailyCredits`. Définissez `dryRun` sur `true` pour prévisualiser les résultats et cette consommation sans rien créer.

Nécessite une offre Business, Agency Business ou Enterprise active, et un jeton d’API dont l’accès en écriture a été activé par un Propriétaire ou un Manager. Consultez [Écrire des données](https://docs.qwairy.co/fr/developers/writing-data.md) pour l’activation, l’idempotence, les requêtes conditionnelles et la gestion des erreurs.

**Authorization** `string` *required*

Jeton bearer de votre équipe.

**Idempotency-Key** `string` *required*

Clé unique pour cette opération, 255 caractères au maximum. Les réponses terminées sont rejouées pendant 24 heures.

**brandId** `string` *required*

Identifiant du workspace. Le workspace doit appartenir à l’équipe du jeton.

**suggestionIds** `string[]` *required*

Entre 1 et 20 identifiants de suggestions issus de [Obtenir les suggestions de prompts](https://docs.qwairy.co/fr/developers/endpoints/prompt-suggestions/get.md).
Chaque identifiant compte 200 caractères au maximum. Les identifiants sont opaques et liés au contenu et à la classification. Relisez-les après une régénération. Une suggestion remplacée renvoie `not_found` au lieu d’accepter un contenu différent.

**keywordId** `string | null`

Topic de chaque prompt accepté. Par défaut, le Topic suggéré.

**tagIds** `string[]`

20 identifiants de Tags au maximum, appliqués à chaque prompt accepté.

**monitoringEnabled** `boolean` (default: true)

Indique si les prompts acceptés participent au suivi planifié.

**dryRun** `boolean` (default: false)

Valide la requête et renvoie les résultats sans créer de prompts.

## Réponse

Renvoie `200` avec `dryRun`, `dailyCredits` et `items`.

| Champ | Signification |
| - | - |
| `dryRun` | Indique si rien n’a été créé |
| `dailyCredits` | Moyenne de crédits par jour ajoutée par les prompts acceptés et suivis |
| `items[].outcome` | `created`, `already_tracked`, `not_found` ou `invalid` |
| `items[].promptId` | Le prompt créé, ou `null` |

Examinez chaque élément : le statut HTTP seul ne signifie pas que toutes les suggestions ont été acceptées.

`already_tracked` signifie qu’un prompt équivalent est déjà actif et suivi, ou qu’une suggestion précédente de la même requête a le même texte. Une suggestion équivalente à un prompt archivé ou en pause réactive ce prompt et renvoie `created`, comme dans le Studio du dashboard. L’import réécrit son texte, son étape du tunnel et son Topic, efface ses pays, et rétablit ses Personas et ses modèles sur les valeurs par défaut du workspace. Sa fréquence, son Boost et sa dernière collecte sont conservés.

L’acceptation ne lance elle-même aucune collecte. Sur un workspace `LIVE`, elle peut rendre des prompts suivis dus au prochain passage du planificateur, qui s’exécute à l’heure et à la demie (UTC) : un nouveau prompt lorsque les réponses automatiques sont activées, ou un prompt réactivé dont la dernière collecte est plus ancienne que sa fréquence. Cette première collecte consomme des crédits une fois, en plus de `dailyCredits`. Cette réponse, `dryRun` compris, n’indique pas ce montant. L’aperçu de l’outil MCP [`accept_prompt_suggestions`](https://docs.qwairy.co/fr/mcp/write/prompt-suggestions#accept_prompt_suggestions) l’indique.

## Requête et réponse synthétiques

```bash theme={null}
curl -X POST "https://www.qwairy.co/api/v1/brands/$BRAND_ID/prompt-suggestions/accept" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H "Idempotency-Key: accept-suggestions-001" \
  -H "Content-Type: application/json" \
  -d '{"suggestionIds":["cccccccc-0000-4000-8000-000000000000","dddddddd-0000-4000-8000-000000000000"],"dryRun":true}'
```

```json theme={null}
{
  "dryRun": true,
  "dailyCredits": 0.6,
  "items": [
    {
      "suggestionId": "cccccccc-0000-4000-8000-000000000000",
      "outcome": "created",
      "promptId": null
    },
    {
      "suggestionId": "dddddddd-0000-4000-8000-000000000000",
      "outcome": "already_tracked",
      "promptId": null
    }
  ]
}
```

## Erreurs

| Statut | Code | Cause |
| - | - | - |
| `400` | `INVALID_REQUEST` | La liste est vide, contient plus de 20 suggestions, ou une valeur est invalide |
| `404` | `RESOURCE_NOT_FOUND` | Le workspace, le Topic ou le Tag est absent ou inaccessible |
| `409` | `CONFLICT` | La requête entre en conflit avec l’état actuel |

Consultez [Codes d’erreur](https://docs.qwairy.co/fr/developers/errors.md) pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Un jeton sans accès en écriture renvoie `403 API_KEY_READ_ONLY`. Sur `429`, respectez `Retry-After`. Si le limiteur d’écriture est indisponible ou si les écritures sont suspendues, la requête renvoie `503 SERVICE_UNAVAILABLE` et rien ne change.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.