Secrets

Los valores que un workflow de agent referencia como ${{secrets.KEY}}.

:::caution Solo escritura El valor nunca se devuelve en ningún comando — ni siquiera justo después de haberlo escrito. Si vas a necesitar la credencial en otro lugar, guárdala antes de almacenarla aquí. :::

Ver el modelo Secret.

Comando	HTTP	Descripción
secrets list	GET /secrets	Lista los secrets del workspace — solo key, notes, last_used_at y timestamps.
secrets get	GET /secrets/{id}	Obtiene los metadatos de un secret. El valor no forma parte de la respuesta.
secrets create	POST /secrets	Guarda un nuevo secret. Una key duplicada se rechaza con 409.
secrets upsert	PUT /secrets	Crea el secret, o rota el valor de uno existente con la misma key.
secrets update	PATCH /secrets/{id}	Reemplaza un valor o sus notas. key es inmutable.
secrets delete	DELETE /secrets/{id}	Soft-delete. Cualquier step de workflow que referencie la key falla desde la siguiente ejecución.

Ejemplos

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

# Obtener metadatos
kobana inbox secrets get --params '{"id": "SECRET_ID"}'

# Crear
kobana inbox secrets create \
  --json '{"key": "ERP_API_TOKEN", "value": "sk_live_...", "notes": "Token de integración con el ERP"}'

# Rotar por key, sin necesidad de lookup
kobana inbox secrets upsert \
  --json '{"key": "ERP_API_TOKEN", "value": "sk_live_new..."}'

# Reemplazar el 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 pasos

• Agents — el workflow que referencia la key de un secret.