Mettre à jour un prompt
curl --request PATCH \
--url https://www.qwairy.co/api/v1/brands/{brandId}/prompts/{promptId} \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'If-Match: <if-match>' \
--data '
{
"text": "<string>",
"status": "<string>",
"frequency": {},
"monitoringEnabled": true,
"keywordId": {},
"tagIds": [
"<string>"
],
"countryCodes": [
"<string>"
],
"modelIds": [
"<string>"
]
}
'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/prompts/{promptId}"
payload = {
"text": "<string>",
"status": "<string>",
"frequency": {},
"monitoringEnabled": True,
"keywordId": {},
"tagIds": ["<string>"],
"countryCodes": ["<string>"],
"modelIds": ["<string>"]
}
headers = {
"Authorization": "<authorization>",
"If-Match": "<if-match>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
Authorization: '<authorization>',
'If-Match': '<if-match>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
text: '<string>',
status: '<string>',
frequency: {},
monitoringEnabled: true,
keywordId: {},
tagIds: ['<string>'],
countryCodes: ['<string>'],
modelIds: ['<string>']
})
};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/prompts/{promptId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Prompts
Mettre à jour un prompt
Modifiez, archivez ou restaurez un prompt, dont son calendrier, son Topic, ses Tags, ses pays et ses modèles, avec l’ETag lu en dernier dans If-Match.
PATCH
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
prompts
/
{promptId}
Mettre à jour un prompt
curl --request PATCH \
--url https://www.qwairy.co/api/v1/brands/{brandId}/prompts/{promptId} \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'If-Match: <if-match>' \
--data '
{
"text": "<string>",
"status": "<string>",
"frequency": {},
"monitoringEnabled": true,
"keywordId": {},
"tagIds": [
"<string>"
],
"countryCodes": [
"<string>"
],
"modelIds": [
"<string>"
]
}
'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/prompts/{promptId}"
payload = {
"text": "<string>",
"status": "<string>",
"frequency": {},
"monitoringEnabled": True,
"keywordId": {},
"tagIds": ["<string>"],
"countryCodes": ["<string>"],
"modelIds": ["<string>"]
}
headers = {
"Authorization": "<authorization>",
"If-Match": "<if-match>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {
Authorization: '<authorization>',
'If-Match': '<if-match>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
text: '<string>',
status: '<string>',
frequency: {},
monitoringEnabled: true,
keywordId: {},
tagIds: ['<string>'],
countryCodes: ['<string>'],
modelIds: ['<string>']
})
};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/prompts/{promptId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Ne met à jour que les champs fournis. Lisez d’abord le prompt avec
Fournissez au moins un champ modifiable.
Consultez Codes d’erreur pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Sur
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.
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.ACTIVE ou ARCHIVED. L’archivage conserve les réponses et l’historique ; définir ACTIVE restaure le prompt.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é.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.
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.
Réponse
Renvoie200, 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
curl -i "https://www.qwairy.co/api/v1/brands/$BRAND_ID/prompts/$PROMPT_ID?view=configuration" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN"
# Assume the returned ETag is "2".
curl -X PATCH "https://www.qwairy.co/api/v1/brands/$BRAND_ID/prompts/$PROMPT_ID" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN" \
-H 'If-Match: "2"' \
-H "Content-Type: application/json" \
-d '{"status":"ARCHIVED"}'
{
"prompt": {
"id": "33333333-0000-4000-8000-000000000000",
"text": "Which CRM tools support small sales teams?",
"status": "ARCHIVED",
"frequency": null,
"monitoringEnabled": true,
"keywordId": null,
"tagIds": ["55555555-0000-4000-8000-000000000000"],
"countryCodes": [],
"modelIds": [],
"version": 3,
"createdAt": "2026-09-01T09:00:00.000Z",
"updatedAt": "2026-09-01T10:00:00.000Z"
}
}
Erreurs
| Statut | Code | Cause |
|---|---|---|
| 400 | INVALID_REQUEST | Aucun champ modifiable ou valeur de champ invalide |
| 404 | RESOURCE_NOT_FOUND | Workspace, prompt, Topic ou Tag absent ou inaccessible |
| 409 | CONFLICT | Texte de prompt en doublon ou workspace non modifiable |
| 412 | PRECONDITION_FAILED | L’ETag est périmé ou invalide |
| 428 | PRECONDITION_REQUIRED | If-Match est absent |
429, respectez Retry-After ; les écritures peuvent renvoyer 503 SERVICE_UNAVAILABLE si le limiteur d’écriture est indisponible.
