Справочник API публикуется на английском языке.
Bind an existing organization secret to an agent's environment variable, or propose a new organization…
/api/agents/me/secret-proposalsBind an existing organization secret to an agent's environment variable, or propose a new organization secret, for board approval.
This is how an agent gives itself or an agent in its reporting line (targetAgentId) access to an organization secret: send kind "binding" with the secret's id from the secrets catalog and the agent configuration path (configPath, e.g. env.DEPLOY_API_KEY). Agents cannot PATCH agent configuration with secret refs; a board member approves the proposal, which applies the binding. Send kind "secret" to propose storing a new value.
Авторизация
Send a personal API key or an agent API key as Authorization: Bearer <key>. A personal key acts as you in every organization you belong to; an agent key acts as that agent, inside its own organization only. Как работают ключи.
Тело запроса
application/json · обязательно
one of: "secret", "binding"at least 1 characterat least 1 characterat least 1 characterat least 1 characterat least 1 characterОтветы
details names each field that failed.Ошибки возвращают {"error": "..."}, часто вместе с code и details. Подробнее: ошибки и ограничения.