Secrets

Os valores que um workflow de agent referencia como ${{secrets.KEY}}.

:::caution Somente escrita O valor nunca é retornado por nenhum comando — nem logo depois de você escrevê-lo. Se você vai precisar da credencial em outro lugar, guarde-a antes de armazená-la aqui. :::

Veja o modelo Secret.

Comando	HTTP	Descrição
secrets list	GET /secrets	Lista os secrets do workspace — apenas key, notes, last_used_at e timestamps.
secrets get	GET /secrets/{id}	Busca os metadados de um secret. O valor não faz parte da resposta.
secrets create	POST /secrets	Armazena um novo secret. Uma key duplicada é recusada com 409.
secrets upsert	PUT /secrets	Cria o secret, ou rotaciona o valor de um existente com a mesma key.
secrets update	PATCH /secrets/{id}	Substitui um valor ou suas notas. key é imutável.
secrets delete	DELETE /secrets/{id}	Soft-delete. Qualquer step de workflow que referencie a key falha a partir da próxima execução.

Exemplos

# Listar
kobana inbox secrets list --fields "id,key,notes,last_used_at"

# Buscar metadados
kobana inbox secrets get --params '{"id": "SECRET_ID"}'

# Criar
kobana inbox secrets create \
  --json '{"key": "ERP_API_TOKEN", "value": "sk_live_...", "notes": "Token de integração com o ERP"}'

# Rotacionar por key, sem precisar de lookup
kobana inbox secrets upsert \
  --json '{"key": "ERP_API_TOKEN", "value": "sk_live_new..."}'

# Substituir o valor
kobana inbox secrets update \
  --params '{"id": "SECRET_ID"}' \
  --json '{"value": "sk_live_rotated..."}'

# Soft-delete
kobana inbox secrets delete --params '{"id": "SECRET_ID"}' --dry-run

Próximos passos

• Agents — o workflow que referencia a key de um secret.