# Télémétrie et optimisation

Déclarer les appels faits hors de la passerelle, choisir un modèle pour une requête, chercher et stocker des réponses en cache, vérifier qu’un agent ne boucle pas, compresser un long contenu et interroger la place de marché des fournisseurs.

[Toute la référence de l’API](https://www.azothos.ai/fr/docs/api)

> Les résumés des routes et les noms des champs sont écrits en anglais, ici comme dans le fichier.

## /api/ingest

### POST /api/ingest

Ingest AI usage events

- **Authentification** — Clé API
- **Portée de la clé** — `ingest:write`
- **Corps** — `events` (obligatoire)
- **Réponses** — `200` · `400` [validation_failed](https://www.azothos.ai/fr/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/fr/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/fr/docs/errors#api_key_invalid) · `402` [budget_exceeded](https://www.azothos.ai/fr/docs/errors#budget_exceeded) · `403` [api_key_scope_denied](https://www.azothos.ai/fr/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/fr/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/fr/docs/errors#ip_not_allowed), [eu_storage_unavailable](https://www.azothos.ai/fr/docs/errors#eu_storage_unavailable) · `413` [validation_failed](https://www.azothos.ai/fr/docs/errors#validation_failed) · `429` [ingest_queue_full](https://www.azothos.ai/fr/docs/errors#ingest_queue_full) · `500` [internal_error](https://www.azothos.ai/fr/docs/errors#internal_error) · `503` [service_unavailable](https://www.azothos.ai/fr/docs/errors#service_unavailable) · `504`

## /api/arbiter

### POST /api/arbiter/route

Select optimal model for a request

- **Authentification** — Clé API
- **Portée de la clé** — `inference:write`
- **Corps** — `agentId` · `promptTokens` · `mode` · `qualityFloor` · `latencyCeilingMs` · `budgetUsd` · `candidates`
- **Réponses** — `200` · `400` [validation_failed](https://www.azothos.ai/fr/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/fr/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/fr/docs/errors#api_key_invalid) · `402` [budget_exceeded](https://www.azothos.ai/fr/docs/errors#budget_exceeded) · `403` [policy_blocked](https://www.azothos.ai/fr/docs/errors#policy_blocked), [sovereignty_blocked](https://www.azothos.ai/fr/docs/errors#sovereignty_blocked), [jurisdiction_blocked](https://www.azothos.ai/fr/docs/errors#jurisdiction_blocked), [kill_switch_active](https://www.azothos.ai/fr/docs/errors#kill_switch_active), [human_review_not_resumable](https://www.azothos.ai/fr/docs/errors#human_review_not_resumable), [api_key_scope_denied](https://www.azothos.ai/fr/docs/errors#api_key_scope_denied) · `429` · `500` [internal_error](https://www.azothos.ai/fr/docs/errors#internal_error) · `503` [budget_unavailable](https://www.azothos.ai/fr/docs/errors#budget_unavailable), [governance_error](https://www.azothos.ai/fr/docs/errors#governance_error)

## /api/cache

### POST /api/cache/lookup

Look up a cached answer for a prompt

- **Authentification** — Clé API
- **Portée de la clé** — `cache:read`
- **Corps** — `prompt` (obligatoire) · `threshold` · `model`
- **Réponses** — `200` · `400` [validation_failed](https://www.azothos.ai/fr/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/fr/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/fr/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/fr/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/fr/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/fr/docs/errors#ip_not_allowed) · `429` · `500` [internal_error](https://www.azothos.ai/fr/docs/errors#internal_error)

### POST /api/cache/store

Store a prompt and its answer in the cache

- **Authentification** — Clé API
- **Portée de la clé** — `cache:write`
- **Corps** — `prompt` (obligatoire) · `response` (obligatoire) · `model` (obligatoire) · `provider` (obligatoire) · `costUsd` · `ttlMs`
- **Réponses** — `200` · `400` [validation_failed](https://www.azothos.ai/fr/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/fr/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/fr/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/fr/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/fr/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/fr/docs/errors#ip_not_allowed) · `429` · `500` [internal_error](https://www.azothos.ai/fr/docs/errors#internal_error)

## /api/loops

### POST /api/loops/check

Check an agent for a loop, reset its counters, or read its state

- **Authentification** — Clé API
- **Portée de la clé** — `advisory:read`
- **Corps** — `action` · `agentId` (obligatoire) · `workflowId` · `prompt` · `model` · `costUsd`
- **Réponses** — `200` · `400` [validation_failed](https://www.azothos.ai/fr/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/fr/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/fr/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/fr/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/fr/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/fr/docs/errors#ip_not_allowed) · `429` · `500` [internal_error](https://www.azothos.ai/fr/docs/errors#internal_error)

## /api/v1/compress

### POST /api/v1/compress

Compress long reasoning content (levels L1 to L3)

- **Authentification** — Clé API
- **Portée de la clé** — `advisory:read`
- **Module** — Servie là où le déploiement fait tourner `FEATURE_CCE`.
- **Corps** — `content` (obligatoire) · `level` · `agentId` · `workflowId` · `traceId`
- **Réponses** — `200` · `400` [validation_failed](https://www.azothos.ai/fr/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/fr/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/fr/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/fr/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/fr/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/fr/docs/errors#ip_not_allowed) · `429` · `500` [internal_error](https://www.azothos.ai/fr/docs/errors#internal_error) · `501` [feature_disabled](https://www.azothos.ai/fr/docs/errors#feature_disabled)

## /api/v1/reconstruct

### POST /api/v1/reconstruct

Reconstruct compressed content from its id

- **Authentification** — Clé API
- **Portée de la clé** — `advisory:read`
- **Module** — Servie là où le déploiement fait tourner `FEATURE_CCE`.
- **Corps** — `cognitiveStateId` (obligatoire)
- **Réponses** — `200` · `400` [validation_failed](https://www.azothos.ai/fr/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/fr/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/fr/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/fr/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/fr/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/fr/docs/errors#ip_not_allowed) · `404` [not_found](https://www.azothos.ai/fr/docs/errors#not_found) · `429` · `500` [internal_error](https://www.azothos.ai/fr/docs/errors#internal_error) · `501` [feature_disabled](https://www.azothos.ai/fr/docs/errors#feature_disabled)

## /api/v1/marketplace

### GET /api/v1/marketplace

The best-fit model of the provider marketplace for your constraints

- **Authentification** — Clé API
- **Portée de la clé** — `advisory:read`
- **Module** — Servie là où le déploiement fait tourner `FEATURE_MARKETPLACE`.
- **Paramètres** — `mode` · `maxCostPer1k` · `maxLatencyMs` · `minQuality` · `requiresVision` · `requiresTools` · `minContextWindow`
- **Réponses** — `200` · `401` [api_key_missing](https://www.azothos.ai/fr/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/fr/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/fr/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/fr/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/fr/docs/errors#ip_not_allowed) · `404` · `429` · `500` [internal_error](https://www.azothos.ai/fr/docs/errors#internal_error) · `501` [feature_disabled](https://www.azothos.ai/fr/docs/errors#feature_disabled)
