Accepter des suggestions de prompts
curl --request POST \
--url https://www.qwairy.co/api/v1/brands/{brandId}/prompt-suggestions/accept \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"suggestionIds": [
"<string>"
]
}
'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/prompt-suggestions/accept"
payload = { "suggestionIds": ["<string>"] }
headers = {
"Authorization": "<authorization>",
"Idempotency-Key": "<idempotency-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: '<authorization>',
'Idempotency-Key': '<idempotency-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({suggestionIds: ['<string>']})
};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/prompt-suggestions/accept', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Suggestions de prompts
Accepter des suggestions de prompts
Créez des prompts à partir de 20 suggestions au plus de la dernière génération. Ils sont suivis par défaut ; dryRun prévisualise le coût quotidien en crédits.
POST
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
prompt-suggestions
/
accept
Accepter des suggestions de prompts
curl --request POST \
--url https://www.qwairy.co/api/v1/brands/{brandId}/prompt-suggestions/accept \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"suggestionIds": [
"<string>"
]
}
'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/prompt-suggestions/accept"
payload = { "suggestionIds": ["<string>"] }
headers = {
"Authorization": "<authorization>",
"Idempotency-Key": "<idempotency-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: '<authorization>',
'Idempotency-Key': '<idempotency-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({suggestionIds: ['<string>']})
};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/prompt-suggestions/accept', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Crée des prompts à partir de 20 suggestions au plus de la dernière génération. Les prompts acceptés sont suivis par défaut, ce qui ajoute une consommation récurrente de crédits indiquée dans
Examinez chaque élément : le statut HTTP seul ne signifie pas que toutes les suggestions ont été acceptées.
Consultez Codes d’erreur pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Un jeton sans accès en écriture renvoie
dailyCredits. Définissez dryRun sur true pour prévisualiser les résultats et cette consommation sans rien créer.
Nécessite une offre Business, Agency Business ou Enterprise active, et un jeton d’API dont l’accès en écriture a été activé par un Propriétaire ou un Manager. Consultez Écrire des données pour l’activation, l’idempotence, les requêtes conditionnelles et la gestion des erreurs.
Clé unique pour cette opération, 255 caractères au maximum. Les réponses terminées sont rejouées pendant 24 heures.
Entre 1 et 20 identifiants de suggestions issus de Obtenir les suggestions de prompts.
Chaque identifiant compte 200 caractères au maximum. Les identifiants sont opaques et liés au contenu et à la classification. Relisez-les après une régénération. Une suggestion remplacée renvoie
not_found au lieu d’accepter un contenu différent.Réponse
Renvoie200 avec dryRun, dailyCredits et items.
| Champ | Signification |
|---|---|
dryRun | Indique si rien n’a été créé |
dailyCredits | Moyenne de crédits par jour ajoutée par les prompts acceptés et suivis |
items[].outcome | created, already_tracked, not_found ou invalid |
items[].promptId | Le prompt créé, ou null |
already_tracked signifie qu’un prompt équivalent est déjà actif et suivi, ou qu’une suggestion précédente de la même requête a le même texte. Une suggestion équivalente à un prompt archivé ou en pause réactive ce prompt et renvoie created, comme dans le Studio du dashboard. L’import réécrit son texte, son étape du tunnel et son Topic, efface ses pays, et rétablit ses Personas et ses modèles sur les valeurs par défaut du workspace. Sa fréquence, son Boost et sa dernière collecte sont conservés.
L’acceptation ne lance elle-même aucune collecte. Sur un workspace LIVE, elle peut rendre des prompts suivis dus au prochain passage du planificateur, qui s’exécute à l’heure et à la demie (UTC) : un nouveau prompt lorsque les réponses automatiques sont activées, ou un prompt réactivé dont la dernière collecte est plus ancienne que sa fréquence. Cette première collecte consomme des crédits une fois, en plus de dailyCredits. Cette réponse, dryRun compris, n’indique pas ce montant. L’aperçu de l’outil MCP accept_prompt_suggestions l’indique.
Requête et réponse synthétiques
curl -X POST "https://www.qwairy.co/api/v1/brands/$BRAND_ID/prompt-suggestions/accept" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN" \
-H "Idempotency-Key: accept-suggestions-001" \
-H "Content-Type: application/json" \
-d '{"suggestionIds":["cccccccc-0000-4000-8000-000000000000","dddddddd-0000-4000-8000-000000000000"],"dryRun":true}'
{
"dryRun": true,
"dailyCredits": 0.6,
"items": [
{
"suggestionId": "cccccccc-0000-4000-8000-000000000000",
"outcome": "created",
"promptId": null
},
{
"suggestionId": "dddddddd-0000-4000-8000-000000000000",
"outcome": "already_tracked",
"promptId": null
}
]
}
Erreurs
| Statut | Code | Cause |
|---|---|---|
400 | INVALID_REQUEST | La liste est vide, contient plus de 20 suggestions, ou une valeur est invalide |
404 | RESOURCE_NOT_FOUND | Le workspace, le Topic ou le Tag est absent ou inaccessible |
409 | CONFLICT | La requête entre en conflit avec l’état actuel |
403 API_KEY_READ_ONLY. Sur 429, respectez Retry-After. Si le limiteur d’écriture est indisponible ou si les écritures sont suspendues, la requête renvoie 503 SERVICE_UNAVAILABLE et rien ne change.
