La referencia de la API se publica en inglés.
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.
Autorización
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. Cómo funcionan las claves.
Cuerpo de la solicitud
application/json · obligatorio
one of: "secret", "binding"at least 1 characterat least 1 characterat least 1 characterat least 1 characterat least 1 characterRespuestas
details names each field that failed.Los errores devuelven {"error": "..."}, a menudo con un code y unos details. Consulta errores y límites.