Passer au contenu principal
POST
Créer un prompt
Crée un prompt sans lancer de collecte de réponses facturable. Utilisez Lancer un run pour demander de nouvelles réponses pour un workspace live. 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
Texte du prompt, 1 à 500 caractères après suppression des espaces en bordure, comme dans le dashboard.
string | null
NONE, DAILY, WEEKLY, MONTHLY, ou null. Omettez-le ou utilisez null pour hériter du calendrier du workspace.
string | null
UUID d’un Topic de ce workspace. Omettez-le ou utilisez null pour créer un prompt non affecté.
string[]
Jusqu’à 50 UUID de Tags de ce workspace. Aucun Tag par défaut. Dans un workspace créé à partir de la v1.21, Qwairy pose le Tag système Branded ou Non-branded d’après le texte du prompt. L’identifiant de l’un ou l’autre Tag système est ignoré si vous l’envoyez.
string[]
Jusqu’à 50 codes de pays en majuscules sur deux lettres issus du catalogue de pays du workspace, les pays dans lesquels ce prompt s’exécute. Omettez-le ou envoyez un tableau vide pour utiliser le pays par défaut du workspace. Gérez le catalogue avec Mettre à jour un workspace.
string[]
Jusqu’à 30 identifiants de modèles pour ce prompt uniquement. Omettez-le ou envoyez un tableau vide pour utiliser les modèles du workspace.

Réponse

Renvoie 201 avec Location, ETag et un prompt contenant id, text, status, frequency (nullable), monitoringEnabled, keywordId (nullable), tagIds, countryCodes, modelIds, version, createdAt et updatedAt. Un nouveau prompt a status: ACTIVE. Dans un workspace créé à partir de la v1.21, il porte aussi un Tag système : tagIds inclut donc son identifiant ; un workspace créé avant n’a pas de Tags système. countryCodes et modelIds reprennent ce que le prompt enregistre : un tableau vide signifie que le prompt utilise le pays ou les modèles par défaut du workspace.

Requête et réponse synthétiques

Opérations liées

Erreurs

Des champs invalides renvoient 400 INVALID_REQUEST ; des identifiants de workspace ou de libellé inaccessibles renvoient 404 RESOURCE_NOT_FOUND. Un texte en doublon, y compris celui d’un prompt archivé, renvoie 409 CONFLICT ; restaurez le prompt archivé au lieu de le recréer. 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.