Public APIAPI ReferenceEnvironment

Replace all app environment variables.

Beta API

The /v1 API contract may change, including breaking changes without compatibility aliases.

PUT/v1/apps/{appId}/env

A team owner or member can replace all environment variables. Each item requires key, target, value, and secret; the body limit is 1 MiB. Plain values support recursive ${NAME} references within the same target or to platform runtime names; $${ escapes a literal ${. Secret values are literal. The complete replacement is validated for malformed, unknown, or cyclic references. Only exact platform runtime names except PORT, and keys starting with NITROSHIP_ISR_ or NITROSHIP_PURGE_, are reserved. Other NITROSHIP_* keys are allowed, but future platform names take precedence over user values. No CLI command performs a full replacement. Only users with a verified email can use this.

Authorization

bearerAuth
AuthorizationBearer <token>

Use an access token obtained by logging in or exchanging an API token. First exchange an ntro_ API token for an access token through the login server.

In: header

Path Parameters

appId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/v1/apps/string/env" \  -H "Content-Type: application/json" \  -d '{    "items": [      {        "key": "string",        "secret": true,        "target": "string",        "value": "string"      }    ]  }'
Empty