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

# Créer un audit de prospection

> Créez un audit de prospection depuis une équipe agence et mettez en file la préparation des prompts, puis relisez-les ou activez la collecte automatique.

Crée un audit de prospection pour l’équipe agence liée à la clé d’API et met en file la préparation des prompts. Utilisez le parcours de relecture par défaut, ou activez explicitement la collecte automatique des réponses.

> [!NOTE]
>
> Nécessite une équipe agence sur une offre Business, Agency Business ou Enterprise active. Les clés d’API existantes fonctionnent sans rotation.

**Authorization** `string` *required*

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

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

Clé unique pour cet audit. Rejouer la même requête renvoie la réponse d’origine au lieu de créer un autre audit.

**url** `string` *required*

URL ou domaine du site du prospect, 2048 caractères au maximum.

**name** `string`

Nom affiché du prospect, 120 caractères au maximum. Par défaut, le domaine normalisé.

**countryCode** `string` (default: US)

Code de marché pris en charge sur deux lettres. Le marché détermine la disponibilité des modèles.

**promptCount** `number` (default: 30)

Nombre de prompts à préparer, de 20 à 100. Avec `customPrompts`, omettez-le ou envoyez le nombre de prompts importés.

**customPrompts** `array`

De 20 à 100 textes de prompts distincts à importer au lieu de générer un ensemble de prompts.

**modelIds** `array`

Modèles à utiliser. Omettez-le pour utiliser les modèles par défaut de l’audit de prospection disponibles sur le marché sélectionné.

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

Définissez `true` pour lancer la collecte de réponses facturable après la préparation des prompts. Gardez `false` pour relire et enregistrer les prompts avant la confirmation.

## Réponse

Renvoie `202` avec un en-tête `Location` pointant vers `GET /api/v1/pitch-audits/{auditId}`.

**pitchAudit.id** `string`

Identifiant opaque de l’audit de prospection.

**pitchAudit.reportUrl** `string`

URL de la ressource du rapport.

**pitchAudit.requiredCredits** `number`

Crédits requis par la configuration de prompts et de modèles sélectionnée.

**pitchAudit.availableCredits** `number`

Solde de l’équipe observé à l’acceptation de l’audit.

**pitchAudit.dispatchStatus** `string`

`QUEUED` lorsque l’envoi a réussi, ou `RECOVERING` lorsque le mécanisme de reprise durable le retentera.

## Requête synthétique

```bash theme={null}
curl -X POST "https://www.qwairy.co/api/v1/pitch-audits" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H "Idempotency-Key: pitch-northstar-001" \
  -H "Content-Type: application/json" \
  -d '{"url":"northstar.example","name":"Northstar Labs","countryCode":"US","promptCount":20}'
```

## Étape suivante

Interrogez [Obtenir un audit de prospection](https://docs.qwairy.co/fr/developers/endpoints/pitch-audits/get.md). Lorsqu’il atteint `AWAITING_PROMPTS`, relisez les prompts renvoyés et enregistrez-les avec l’`ETag` de la réponse, puis confirmez l’audit.

## Erreurs

| Statut | Code | Cause |
| - | - | - |
| `400` | `INVALID_REQUEST` | Domaine, marché, prompt ou sélection de modèles invalide |
| `403` | `INSUFFICIENT_PLAN` | L’équipe n’est pas une équipe agence sur une offre avec écriture |
| `409` | `INSUFFICIENT_CREDITS` | Le solde de l’équipe ne couvre pas la collecte de réponses sélectionnée |
| `409` | `IDEMPOTENCY_CONFLICT` | Clé réutilisée avec un corps différent |


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