Démarrer
Authentification
La clé API porteuse, ses droits, sa révocation et son expiration.
Chaque requête /v1 porte votre clé API dans l'en-tête Authorization, au format porteur (« Bearer ») :
Authorization: Bearer leem_sk_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Il n'y a ni session, ni cookie, ni CORS sur /v1 : cette clé est réservée à un appel serveur à serveur, jamais à un navigateur. Un appel sans en-tête Authorization, ou avec une valeur vide, reçoit 401 missing_api_key.
Droits (scopes)
Une clé porte un ou plusieurs droits parmi runs et agents, choisis à sa création :
| Point d'entrée | Droit requis |
|---|---|
GET /v1/organization | aucun (toute clé valide) |
GET /v1/tools | runs ou agents |
GET /v1/agents, GET /v1/agents/{agent} | runs ou agents |
POST /v1/agents, PATCH /v1/agents/{agent}, DELETE /v1/agents/{agent} | agents |
POST /v1/runs, GET /v1/runs/{run}, POST /v1/runs/{run}/cancel, GET /v1/runs/{run}/events | runs |
POST /v1/webhook_secret | agents |
POST /v1/files, GET /v1/files/{file}, DELETE /v1/files/{file} | runs |
GET /v1/files/{file}/content | aucun (lien signé, voir plus bas) |
Une clé qui n'a pas le droit requis reçoit 403 insufficient_scope, avec le ou les droits attendus dans le message.
Le seul point d'entrée qui ne demande pas de clé du tout est le téléchargement d'un fichier produit par un run (GET /v1/files/{file}/content) : son URL est signée et destinée à être remise telle quelle à un utilisateur final, qui n'a pas de clé API.
Révocation et expiration
Une clé révoquée cesse de fonctionner immédiatement : la requête suivante (même déjà en vol côté client) reçoit 401 api_key_revoked. Une clé avec une date d'expiration passée reçoit 401 api_key_expired. Une clé invalide (mal formée, inconnue) reçoit 401 invalid_api_key.
request_id et support
Chaque réponse /v1, succès ou erreur, porte un en-tête X-Request-Id et, dans le corps d'une erreur, le même identifiant sous request_id (format req_…). Cet identifiant est généré par leem, jamais repris d'un en-tête que vous auriez envoyé : conservez-le pour toute demande au support, il permet de retrouver l'appel exact dans les journaux.