Passer au contenu principal
POST
Mettre à jour des prompts en masse
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 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 pour l’idempotence, les requêtes conditionnelles et la gestion des erreurs.
string
requis
Jeton bearer de votre équipe.
string
requis
Clé unique pour cette opération. Les réponses terminées sont rejouées pendant 24 heures.
string
requis
Identifiant du workspace. Le workspace doit appartenir à l’équipe du jeton.
string
requis
archive, restore, frequency, topic ou tags.
string[]
requis
Entre 1 et 20 UUID de prompts. Les identifiants en double sont traités une seule fois.
string | null
Obligatoire pour frequency : NONE, DAILY, WEEKLY, MONTHLY, ou null pour hériter du calendrier du workspace.
string | null
Obligatoire pour topic : l’UUID d’un Topic du workspace, ou null pour détacher.
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é.
boolean
défaut:"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 : 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

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