Lister les runs
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/runs \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/runs"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Configurer les données
Lister les runs
Listez les runs récents d’un workspace, du plus récent au plus ancien, avec leur statut, le décompte des résultats et une pagination par curseur.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
runs
Lister les runs
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/runs \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/runs"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Liste les runs du workspace du plus récent au plus ancien. Utilisez cet endpoint pour suivre la collecte des réponses une fois qu’un run a été accepté. La lecture est disponible à partir de Growth et Agency Growth.
Réponse
Renvoie200 avec success, runs, nextCursor, totalCount et activeCount. Les totaux décrivent le workspace entier, pas seulement la page renvoyée. nextCursor: null signifie qu’il n’y a pas de page suivante. Les réponses sont private, no-store.
Chaque run inclut son identité et ses horodatages, purpose, priority, scheduledFrequency (nullable), questionCount, modelCount, requestedCount, plannedCount, planningCompletedAt, planningFailed, status, counts, terminalCount et progressPercentage.
Le statut est l’un de QUEUED, PROCESSING, COMPLETED, COMPLETED_WITH_WARNINGS, FAILED, CANCELLED ou NO_WORK. counts distingue success, warning, failed, cancelled, processing, queued et skipped. L’avancement ne garantit pas que chaque réponse demandée a réussi ; examinez le statut et le décompte des résultats.
Requête et réponse synthétiques
curl "https://www.qwairy.co/api/v1/brands/$BRAND_ID/runs?limit=20" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN"
{
"success": true,
"totalCount": 1,
"activeCount": 0,
"runs": [
{
"id": "55555555-0000-4000-8000-000000000000",
"purpose": "MANUAL",
"priority": "URGENT",
"scheduledFrequency": null,
"questionCount": 12,
"modelCount": 2,
"requestedCount": 24,
"plannedCount": 24,
"planningCompletedAt": "2026-09-01T09:00:01.000Z",
"planningFailed": false,
"createdAt": "2026-09-01T09:00:00.000Z",
"updatedAt": "2026-09-01T09:03:00.000Z",
"status": "COMPLETED",
"counts": {
"success": 24,
"warning": 0,
"failed": 0,
"cancelled": 0,
"processing": 0,
"queued": 0,
"skipped": 0
},
"terminalCount": 24,
"progressPercentage": 100
}
],
"nextCursor": null
}
Erreurs
Des curseurs ou des limites invalides renvoient400 INVALID_PARAMETER ; un workspace inaccessible renvoie 404 BRAND_NOT_FOUND. Consultez Codes d’erreur et respectez Retry-After sur 429.
