Passer au contenu principal
PATCH
Mettre à jour un prompt
Ne met à jour que les champs fournis. Lisez d’abord le prompt avec view=configuration, y compris pour restaurer un prompt archivé. L’archivage préserve ses réponses enregistrées et son historique. 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
Copiez l’ETag complet du dernier GET, guillemets compris.
string
requis
Identifiant du workspace. Le workspace doit appartenir à l’équipe du jeton.
string
requis
UUID du prompt dans le workspace.
string
Texte de remplacement, 1 à 500 caractères après suppression des espaces en bordure, comme dans le dashboard. Lorsque le texte change dans un workspace créé à partir de la v1.21, Qwairy pose de nouveau le Tag système Branded ou Non-branded d’après le nouveau texte.
string
ACTIVE ou ARCHIVED. L’archivage conserve les réponses et l’historique ; définir ACTIVE restaure le prompt.
string | null
NONE, DAILY, WEEKLY, MONTHLY, ou null pour hériter du calendrier du workspace.
boolean
Indique si le prompt participe au suivi planifié.
string | null
UUID d’un Topic de ce workspace, ou null pour détacher son Topic actuel.
string[]
Liste de remplacement complète d’au plus 50 UUID de Tags de ce workspace. Un tableau vide retire tous les Tags, sauf le Tag système Branded ou Non-branded que porte le prompt, s’il en a un. Dans un workspace créé à partir de la v1.21, Qwairy pose ce Tag d’après le texte du prompt. L’identifiant de l’un ou l’autre Tag système dans cette liste est ignoré, et celui que porte le prompt est conservé.
string[]
Liste de remplacement complète d’au plus 50 codes de pays en majuscules sur deux lettres issus du catalogue de pays du workspace. Un tableau vide rétablit le pays par défaut du workspace.
string[]
Liste de remplacement complète d’au plus 30 identifiants de modèles pour ce prompt uniquement. Un tableau vide rétablit les modèles du workspace.
Fournissez au moins un champ modifiable.

Réponse

Renvoie 200, un ETag mis à jour et un objet prompt avec les champs ci-dessous, dont countryCodes et modelIds (des tableaux vides signifient les valeurs par défaut du workspace). Il n’y a pas de champ success au premier niveau. Les dates suivent le format ISO 8601. La version est une valeur de concurrence opaque.

Requête et réponse synthétiques

Erreurs

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.