La référence de l'API est publiée en anglais.
Mint a short-lived token for an agent connection
POST
/api/agents/me/connections/{connectionId}/tokenPersonal API keyConsole session
Mint a short-lived token for an agent connection.
Autorisation
Send a personal API key as Authorization: Bearer <key>. It acts as you, with your permissions in each organization. Agent API keys are refused with 403. Fonctionnement des clés.
Paramètres de chemin
connectionIdstringObligatoireThe connection's id.
Corps de la requête
application/json · obligatoire
subjectobjectFacultatif
scopestring | array<string>Facultatif
requestedTtlSecondsintegerFacultatif
> 0≤ 86400grantIdstring (uuid)Facultatif
Réponses
200SuccessThe request worked; the body holds the result.
401UnauthorizedNo key, or the key is unknown, revoked or expired.
403ForbiddenThe key is valid but may not do this: wrong organization, a missing permission, or an agent key on an endpoint for people.
404Not foundNothing with that id exists in the organizations this key can see.
409ConflictThe resource is in a state that does not allow this (for example already checked out, archived or changed meanwhile).
429Too many requestsToo many requests; wait for
Retry-After seconds.Les erreurs renvoient {"error": "..."}, souvent avec un code et des details. Voir erreurs et limites.