API referansı İngilizce yayımlanır.
Connect a person's terminal to Veyra Intelligence: create a CLI auth challenge for terminal login
/api/cli-auth/challengesConnect a person's terminal to Veyra Intelligence: create a CLI auth challenge for terminal login.
Called by the Veyra Intelligence CLI in a person's own terminal, never by an agent on their behalf. To connect someone's terminal to Veyra Intelligence as themselves, tell them to run veyra auth login --api-base <this Veyra URL> in that terminal (add --company-id <companyId> to name the organization). The URL is the address the person already opens Veyra Intelligence at in their browser; leave it as that placeholder instead of looking it up, because addresses an agent can see (such as a runner-local API URL) may not be reachable from the person's machine. The CLI prints an approval link; they open it in a browser where they are signed in, review the requesting command, organization and Board access, and approve. Only that CLI receives the resulting personal credential. veyra auth whoami confirms who it is signed in as and veyra auth logout revokes it. Agent API keys are a separate identity: never hand out an agent key, create or approve a challenge yourself, or ask for the person's password in chat.
Yetkilendirme
No API key is needed: the token or id in the path, or the request's own signature, authenticates the call. Anahtarlar nasıl çalışır.
İstek gövdesi
application/json · zorunlu
1–240 charactersat most 120 charactersone of: "board", "instance_admin_required"Yanıtlar
details names each field that failed.Hatalar {"error": "..."} döndürür, çoğu zaman bir code ve details ile birlikte. Ayrıntılar için: hatalar ve limitler.