API referansı İngilizce yayımlanır.

Mint a short-lived token for an agent connection

POST/api/agents/me/connections/{connectionId}/token
Personal API keyConsole session
Veyra Docs TeamGüncellendi Sürüm 3 · Geçmiş

Mint a short-lived token for an agent connection.

Yetkilendirme

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. Anahtarlar nasıl çalışır.

Yol parametreleri

connectionIdstringZorunluThe connection's id.

İstek gövdesi

application/json · zorunlu

subjectobjectİsteğe bağlı
scopestring | array<string>İsteğe bağlı
requestedTtlSecondsintegerİsteğe bağlı> 0≤ 86400
grantIdstring (uuid)İsteğe bağlı

Yanıtlar

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.

Hatalar {"error": "..."} döndürür, çoğu zaman bir code ve details ile birlikte. Ayrıntılar için: hatalar ve limitler.

Tools