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

# Enregistrer les prompts d’un audit de prospection

> Remplacez le brouillon de relecture des prompts d’un audit de prospection avec l’ETag de la dernière lecture, sans écraser une modification concurrente.

Remplace l’ensemble des prompts tant qu’un audit de prospection est en `AWAITING_PROMPTS` et dans la phase `PROMPT_REVIEW`. Lisez d’abord l’audit et écrivez avec son `ETag` actuel pour qu’une modification du tableau de bord ou de l’API ne soit pas écrasée en silence.

**Authorization** `string` *required*

Jeton bearer. Exemple : `Bearer qw-api-xxx`

**If-Match** `string` *required*

`ETag` renvoyé par la dernière réponse de [Obtenir un audit de prospection](https://docs.qwairy.co/fr/developers/endpoints/pitch-audits/get.md).

**auditId** `string` *required*

Identifiant de l’audit de prospection appartenant à l’équipe agence de la clé d’API.

**prompts** `array` *required*

Ensemble de remplacement complet contenant de 20 à 100 prompts. Les identifiants de prompts doivent être uniques. Un draft inchangé créé avant cette règle garde son nombre de prompts.

Chaque prompt contient :

| Champ | Type | Contrat |
| - | - | - |
| `id` | string | Identifiant unique, 50 caractères au maximum |
| `text` | string | Texte du prompt, 1000 caractères au maximum |
| `category` | string | `TOFU`, `MOFU` ou `BOFU` |
| `topic` | string | Libellé du Topic, 120 caractères au maximum |

## Requête synthétique

```bash theme={null}
curl -X PATCH "https://www.qwairy.co/api/v1/pitch-audits/$AUDIT_ID/prompts" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H 'If-Match: "1788350400000"' \
  -H "Content-Type: application/json" \
  -d '{"prompts":[{"id":"p1","text":"Which platform fits a growing revenue team?","category":"MOFU","topic":"Platform selection"}]}'
```

## Réponse

Renvoie `200` avec les prompts enregistrés, la nouvelle `revision` et un nouvel `ETag`. Utilisez cette nouvelle valeur si une autre modification de prompts est nécessaire.

## Erreurs

| Statut | Code | Cause |
| - | - | - |
| `404` | `RESOURCE_NOT_FOUND` | L’audit est absent ou appartient à une autre équipe |
| `409` | `INVALID_STATE_TRANSITION` | L’audit n’attend plus la relecture des prompts |
| `412` | `PRECONDITION_FAILED` | L’audit a changé après l’`ETag` fourni |
| `428` | `PRECONDITION_REQUIRED` | `If-Match` est absent |


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