Справочник API публикуется на английском языке.

Task a single-use workspace login handoff

POST/api/execution-workspaces/{id}/login-handoff
Personal API keyConsole session
Veyra Docs TeamОбновлено Версия 3 · История

Task a single-use workspace login handoff.

Mints a short-lived, single-use ticket the isolated workspace exchanges for its own instance-scoped session, so opening a managed workspace does not depend on a cloned password. Board actors only. The response url must be navigated to, not stored: the workspace answers it with a redirect so the ticket never enters browser history. A refusal carries a machine reason and, where the control plane probed it, the workspace's own readiness.

Авторизация

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. Как работают ключи.

Параметры пути

idstringОбязательныйThe execution workspace's id.

Тело запроса

application/json · обязательно

nextstringНеобязательный

Ответы

201SuccessCreated; the body holds the new resource.
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).
501Internal server error

Ошибки возвращают {"error": "..."}, часто вместе с code и details. Подробнее: ошибки и ограничения.

Workspaces