Secrets

📄️Listar secrets

Paginación por keyset. Los filtros son query params tipados (`campo=valor`, `campo[op]=valor`). El valor de un secret nunca lo devuelve ningún endpoint: se guarda cifrado y solo lo lee el ejecutor de workflows. Para rotarlo, haga `PATCH` sobre la fila (o `PUT` por `key`) con un nuevo `value`.

📄️Crear secret

Guarda un secret que un workflow del agente puede referenciar como `${{secrets.KEY}}`. Una `key` duplicada en el workspace se rechaza con 409 `conflict`. El valor es de solo escritura: se guarda cifrado y nunca se devuelve.

📄️Crear o actualizar secret

Upsert emparejado por `key` dentro del workspace de quien llama — el camino de la rotación, sin buscar el id. Crea con 201 cuando la clave es nueva, reemplaza el valor con 200 cuando ya existe. El valor es de solo escritura.

📄️Obtener secret

Accepts either the internal UUID or the resource `external_id`.

📄️Actualizar secret

Reemplaza el valor o las notas. `key` es inmutable: los workflows la referencian por nombre, así que renombrarla los rompería en silencio — elimine y cree de nuevo.

📄️Eliminar secret

Borrado lógico. Los pasos de workflow que referencian la clave empiezan a fallar con `secret not defined` desde la siguiente ejecución.