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

# Confirmer un audit de prospection

> Confirmez l’ensemble de prompts enregistré d’un audit de prospection et mettez en file la collecte asynchrone des réponses, étape facturable du parcours manuel.

Confirme l’ensemble de prompts enregistré et met en file la collecte asynchrone des réponses. C’est la transition facturable du parcours de relecture manuelle.

**Authorization** `string` *required*

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

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

Clé unique pour cette confirmation. Rejouer la même requête renvoie la réponse d’origine au lieu de lancer une autre vague de réponses.

**auditId** `string` *required*

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

**prompts** `array`

Ensemble de remplacement final facultatif de 20 à 100 prompts, avec les champs de [Enregistrer les prompts d’un audit de prospection](https://docs.qwairy.co/fr/developers/endpoints/pitch-audits/save-prompts.md). Omettez-le pour confirmer les prompts enregistrés.

**modelIds** `array`

Sélection finale de modèles facultative. Omettez-la pour utiliser les modèles enregistrés sur l’audit.

## Requête synthétique

```bash theme={null}
curl -X POST "https://www.qwairy.co/api/v1/pitch-audits/$AUDIT_ID/confirm" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H "Idempotency-Key: confirm-pitch-northstar-001" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Réponse

Renvoie `202` avec un en-tête `Location` pointant vers l’audit. La réponse inclut `requiredCredits`, `availableCredits` et `dispatchStatus`. Interrogez [Obtenir un audit de prospection](https://docs.qwairy.co/fr/developers/endpoints/pitch-audits/get.md), ou listez les audits, pour suivre l’avancement jusqu’à `RUNNING`, `RECOVERING`, `COMPLETED` ou `FAILED`.

Les crédits sont débités par le flux existant de réponses de l’audit de prospection à mesure que les réponses se terminent. Un rejeu réussi de la même confirmation idempotente ne crée pas une seconde vague de réponses.

## Erreurs

| Statut | Code | Cause |
| - | - | - |
| `400` | `INVALID_REQUEST` | Aucun prompt ou aucun modèle pris en charge n’est disponible |
| `404` | `RESOURCE_NOT_FOUND` | L’audit est absent ou appartient à une autre équipe |
| `409` | `INVALID_STATE_TRANSITION` | L’audit n’attend pas de confirmation |
| `409` | `INSUFFICIENT_CREDITS` | Le solde actuel ne couvre pas la vague de réponses |
| `409` | `IDEMPOTENCY_CONFLICT` | Clé réutilisée avec une requête différente |

Des confirmations simultanées du même audit ne lancent la collecte des réponses
qu’une fois. Les autres requêtes reçoivent `409 INVALID_STATE_TRANSITION`.


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