Add or update app environment variables.
Beta API
The /v1 API contract may change, including breaking changes without compatibility aliases.
/v1/apps/{appId}/env/itemsA team owner or member can upsert the specified variables. Each item requires key, target, value, and secret; the body limit is 1 MiB. Plain ${NAME} templates are validated against the merged same-target set and platform runtime names; secret values are literal. Malformed, unknown, and cyclic references are rejected. 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. CLI: ntro env add (use --force to overwrite and --no-sensitive for a plain template). Only users with a verified email can use this.
Authorization
bearerAuth 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
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 POST "https://example.com/v1/apps/string/env/items" \ -H "Content-Type: application/json" \ -d '{ "items": [ { "key": "string", "secret": true, "target": "string", "value": "string" } ] }'