v1

latestOpenAPI 3.1.02026-07-22304756.7 KB
Box

Update Box secrets setup

post/secrets

Request body

envContentsstring

Full .env-style content to sync into Boxes. Send the complete desired file contents, not a patch.

Example request

{
  "envContents": "OPENAI_API_KEY=sk-...\nDATABASE_URL=postgres://...",
  "secretFiles": [
    {
      "path": ".config/service-account.json",
      "contents": "{\"type\":\"service_account\"}"
    }
  ]
}

Response

Updated secret setup metadata.

okboolean required
typestring required

Stable success envelope discriminator added by v1.

successboolean
environmentIdstring required
envContentsstring required
pushedobject

Present on update; counts how many active Boxes received the new environment.

Example response

{
  "ok": true,
  "secretFiles": [
    {
      "path": ".config/service-account.json"
    }
  ]
}