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

# Mettre à jour des prompts en masse

> Appliquez une opération à 20 prompts au plus (archiver, restaurer, fréquence, Topic ou Tags), prévisualisez-la avec dryRun et examinez chaque résultat.

Applique l’opération demandée à chaque prompt accessible et renvoie un résultat par élément. Cet endpoint repose sur l’idempotence plutôt que sur des ETags par prompt. Utilisez [Mettre à jour un prompt](https://docs.qwairy.co/fr/developers/endpoints/prompts/update.md) lorsque vous avez besoin d’une mise à jour conditionnelle sur une version connue.

Nécessite une offre Business, Agency Business ou Enterprise active. Utilisez un jeton d’API dont l’accès en écriture est activé. Consultez [Écrire des données](https://docs.qwairy.co/fr/developers/writing-data.md) pour 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. 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.

**operation** `string` *required*

`archive`, `restore`, `frequency`, `topic` ou `tags`.

**promptIds** `string[]` *required*

Entre 1 et 20 UUID de prompts. Les identifiants en double sont traités une seule fois.

**frequency** `string | null`

Obligatoire pour `frequency` : `NONE`, `DAILY`, `WEEKLY`, `MONTHLY`, ou `null` pour hériter du calendrier du workspace.

**keywordId** `string | null`

Obligatoire pour `topic` : l’UUID d’un Topic du workspace, ou `null` pour détacher.

**tagIds** `string[]`

Obligatoire pour `tags` : la liste de remplacement complète, 50 UUID de Tags au maximum. Envoyez `[]` pour retirer tous les Tags, sauf le Tag système de chaque prompt, s’il en a un. Dans un workspace créé à partir de la v1.21, Qwairy pose le Tag système `Branded` ou `Non-branded` d’après le texte de chaque prompt. L’identifiant de l’un ou l’autre Tag système dans cette liste est ignoré, et celui que porte déjà chaque prompt est conservé.

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

Valide la requête et renvoie les résultats par élément sans rien modifier.

## Réponse

Renvoie `200` avec `operation`, `updated` et `results`. Examinez chaque résultat même lorsque la requête HTTP réussit :

| Statut de l’élément | Signification |
| - | - |
| `updated` | Le prompt a changé |
| `unchanged` | L’état demandé était déjà appliqué |
| `not_found` | Le prompt est absent ou extérieur à ce workspace et à cette équipe |

`updated` ne compte que les éléments dont le statut est `updated`. L’archivage conserve les réponses et l’historique.

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

```bash theme={null}
curl -X POST "https://www.qwairy.co/api/v1/brands/$BRAND_ID/prompts/bulk" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H "Idempotency-Key: archive-prompt-batch-001" \
  -H "Content-Type: application/json" \
  -d '{"operation":"archive","promptIds":["33333333-0000-4000-8000-000000000000","44444444-0000-4000-8000-000000000000"]}'
```

```json theme={null}
{
  "operation": "archive",
  "updated": 1,
  "results": [
    { "promptId": "33333333-0000-4000-8000-000000000000", "status": "updated" },
    {
      "promptId": "44444444-0000-4000-8000-000000000000",
      "status": "unchanged"
    }
  ]
}
```

## Erreurs

Des opérations ou des charges utiles invalides renvoient `400 INVALID_REQUEST`. Un workspace, un Topic ou un Tag inaccessible renvoie `404 RESOURCE_NOT_FOUND`. Les identifiants de prompts introuvables sont signalés élément par élément.

Consultez [Codes d’erreur](https://docs.qwairy.co/fr/developers/errors.md) pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Sur `429`, respectez `Retry-After` ; les écritures peuvent renvoyer `503 SERVICE_UNAVAILABLE` si le limiteur d’écriture est indisponible.


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