La referencia de la API se publica en inglés.
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.
Autorización
No API key is needed: the token or id in the path, or the request's own signature, authenticates the call. Cómo funcionan las claves.
Cuerpo de la solicitud
application/json · obligatorio
1–240 charactersat most 120 charactersone of: "board", "instance_admin_required"Respuestas
details names each field that failed.Los errores devuelven {"error": "..."}, a menudo con un code y unos details. Consulta errores y límites.