Mettre à jour des prompts en masse
curl --request POST \
--url https://www.qwairy.co/api/v1/brands/{brandId}/prompts/bulk \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"operation": "<string>",
"promptIds": [
"<string>"
]
}
'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/prompts/bulk"
payload = {
"operation": "<string>",
"promptIds": ["<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({operation: '<string>', promptIds: ['<string>']})
};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/prompts/bulk', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Prompts
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.
POST
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
prompts
/
bulk
Mettre à jour des prompts en masse
curl --request POST \
--url https://www.qwairy.co/api/v1/brands/{brandId}/prompts/bulk \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"operation": "<string>",
"promptIds": [
"<string>"
]
}
'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/prompts/bulk"
payload = {
"operation": "<string>",
"promptIds": ["<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({operation: '<string>', promptIds: ['<string>']})
};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/prompts/bulk', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));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.
Clé unique pour cette opération. Les réponses terminées sont rejouées pendant 24 heures.
Entre 1 et 20 UUID de prompts. Les identifiants en double sont traités une seule fois.
Obligatoire pour
frequency : NONE, DAILY, WEEKLY, MONTHLY, ou null pour hériter du calendrier du workspace.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é.Réponse
Renvoie200 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
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"]}'
{
"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 renvoient400 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.
