Lister les runs

Retourne l'historique des runs de tous les boosts, du plus récent au plus ancien.

GET /v1/runs

Scope requis : runs:read

Paramètres de requête

Paramètre	Type	Requis	Description
`boost_id`	integer	Optionnel	Filtrer par identifiant de boost.
`limit`	integer	Optionnel	Nombre de résultats par page. Défaut : `20`, max : `100`.
`offset`	integer	Optionnel	Décalage de pagination. Défaut : `0`.

Exemple de requête

curl "https://api.cache-boost.com/v1/runs?boost_id=15&limit=20" \
  -H "Authorization: Bearer cb_live_YOUR_KEY"

Réponse

Retourne 200 OK avec une liste paginée de runs.

{
  "data": [
    {
      "id": 88,
      "boost_id": 15,
      "status": "done",
      "status_message": null,
      "started_at": "2025-01-15T01:00:05Z",
      "finished_at": "2025-01-15T01:04:22Z",
      "summary": {
        "total_calls": 1240,
        "successful_calls": 1238,
        "failed_calls": 2,
        "cache_hits": 1165,
        "average_response_time_ms": 112.5,
        "pops": {"CDG": 620, "AMS": 618}
      },
      "created_at": "2025-01-15T01:00:00Z"
    }
  ],
  "limit": 20,
  "offset": 0
}

Valeurs de statut

Valeur	Description
`pending`	Run en attente de démarrage.
`running`	Run en cours.
`done`	Run terminé avec succès.
`failed`	Run terminé avec des erreurs.
`paused`	Run mis en pause suite à un taux d'erreur élevé.

Erreurs

Code	Description
`401`	Clé API manquante ou invalide.
`403`	Scope insuffisant.