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

POST/api/cli-auth/challenges
No API key
Veyra Docs TeamActualizado el Versión 4 · Historial

Connect 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

commandstringObligatorio1–240 characters
clientNamestring | nullOpcionalat most 120 characters
requestedAccessstringOpcionalone of: "board", "instance_admin_required"
requestedCompanyIdstring (uuid) | nullOpcional

Respuestas

201SuccessCreated; the body holds the new resource.
400Bad requestThe request is malformed or failed validation. details names each field that failed.

Los errores devuelven {"error": "..."}, a menudo con un code y unos details. Consulta errores y límites.

Members, invites and keys