Secrets
Listar secrets
Paginação por keyset. Os filtros são query params tipados (`campo=valor`, `campo[op]=valor`). O valor de um secret nunca é devolvido por nenhum endpoint: ele é guardado criptografado e só é lido pelo executor de workflows. Para rotacioná-lo, faça `PATCH` na linha (ou `PUT` por `key`) com um novo `value`.
Criar secret
Guarda um secret que um workflow do agente pode referenciar como `${{secrets.KEY}}`. Uma `key` duplicada no workspace é recusada com 409 `conflict`. O valor é somente escrita: guardado criptografado e nunca devolvido.
Criar ou atualizar secret
Upsert casado por `key` dentro do workspace de quem chama — o caminho da rotação, sem precisar buscar o id. Cria com 201 quando a chave é nova, substitui o valor com 200 quando já existe. O valor é somente escrita.
Obter secret
Accepts either the internal UUID or the resource `external_id`.
Atualizar secret
Substitui o valor ou as notas. `key` é imutável: os workflows a referenciam pelo nome, então renomeá-la os quebraria silenciosamente — exclua e crie de novo.
Excluir secret
Soft delete. Passos de workflow que referenciam a chave passam a falhar com `secret not defined` a partir da próxima execução.