plane: bothresource: SecretC5rendered from forge v1.56.0 platform-model.json

set-secret

Seal a secret (AES-256-GCM) into the vault; the Secret resource carries the name only, never the value.

SetSecretPOST /capabilities/set-secret

Secretthe Resource it produces

1 eventSecretSet

Ask your agent forge → set-secret

you

Store hello's SMTP URL as a secret.

claude

forge → set-secret Done — Secret created; I recorded SecretSet.

From the terminal

$ forge secrets set --app hello --name SMTP_URL --from-env SMTP_URL

HTTP either plane

POST /capabilities/set-secret
Content-Type: application/json
x-forge-actor-type: builder
x-forge-actor-id: cli

{
  "app": "hello",
  "name": "SMTP_URL",
  "value": "…"
}

Input fields 3

app
name
value

Events ForgeEvent

SecretSet   resource_type: Secret

Resource GET /resources/Secret/:id

{
  "type": "Secret",
  "id": "res_01J…",
  "app_id": "app_hello",
  "status": "succeeded",
  "created_at": "2026-09-03T14:00:00Z"
}

Errors: see Reference → Errors. Find it in the playground