Créer un Topic
curl --request POST \
--url https://www.qwairy.co/api/v1/brands/{brandId}/keywords \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"text": "<string>"
}
'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/keywords"
payload = { "text": "<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({text: '<string>'})
};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/keywords', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Topics
Créer un Topic
Créez un libellé de Topic pour organiser les prompts d’un workspace. Le chemin de l’API garde le nom keywords ; affectez le Topic via une mise à jour de prompt.
POST
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
keywords
Créer un Topic
curl --request POST \
--url https://www.qwairy.co/api/v1/brands/{brandId}/keywords \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"text": "<string>"
}
'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/keywords"
payload = { "text": "<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({text: '<string>'})
};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/keywords', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Crée un libellé de Topic. Le chemin de l’API garde le nom
keywords ; la ressource est un Topic. Utilisez Mettre à jour un prompt pour l’affecter.
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.
Réponse
Renvoie201 avec Location, ETag et un topic contenant id, text, version, createdAt et updatedAt.
Requête et réponse synthétiques
curl -X POST "https://www.qwairy.co/api/v1/brands/$BRAND_ID/keywords" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN" \
-H "Idempotency-Key: topic-pricing-001" \
-H "Content-Type: application/json" \
-d '{"text":"Pricing"}'
{
"topic":{
"id":"11111111-0000-4000-8000-000000000000",
"text":"Pricing",
"version":0,
"createdAt":"2026-09-01T09:00:00.000Z",
"updatedAt":"2026-09-01T09:00:00.000Z"
}
}
Opérations liées
- Obtenir un Topic, le mettre à jour ou le supprimer.
- Lister les Topics avec
view=configurationpour inclure les libellés sans réponse et leurs versions actuelles. - Créer un Tag pour des libellés secondaires réutilisables.
Erreurs
Un texte invalide renvoie400 INVALID_REQUEST ; un workspace inaccessible renvoie 404 RESOURCE_NOT_FOUND ; un libellé en doublon renvoie 409 CONFLICT.
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.
