Set environment variables

curl --request PATCH \
  --url https://api.storiza.store/apps/{id}/environment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "env": {}
}'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({env: {}})
};

fetch('https://api.storiza.store/apps/{id}/environment', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.storiza.store/apps/{id}/environment"

payload = { "env": {} }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "message": "Environment updated",
  "data": {
    "id": "00000000-0000-4000-8000-000000000000",
    "name": "Survival",
    "hostname": "mc-survival",
    "type": "game_server",
    "owner": {
      "id": "00000000-0000-4000-8000-000000000000"
    },
    "subscription": {
      "id": "00000000-0000-4000-8000-000000000000"
    },
    "node": {
      "id": "00000000-0000-4000-8000-000000000000"
    },
    "template": {
      "id": "00000000-0000-4000-8000-000000000000"
    },
    "version": "latest",
    "plan": {
      "id": "00000000-0000-4000-8000-000000000000"
    },
    "group": null,
    "state": "running",
    "sftpUsername": "app-mc-survival",
    "createdAt": "2026-10-09T14:57:33.884Z"
  }
}

Apps

Set environment variables

Replace the app’s environment variables. The body is the complete set — a key you leave out is removed.

Validated against the template immediately, so a locked, unknown or out-of-range value is refused while you are still looking at the form rather than at the next restart. A variable the template marks non-mutable cannot be set at all, and one it never declared is rejected rather than passed into the image.

Takes effect on the next start. The container is built from these values when it is created, so a running app keeps the environment it was created with — restart it to apply.

Required API key permission: apps:write

PATCH

/

apps

/

{id}

/

environment

Set environment variables

curl --request PATCH \
  --url https://api.storiza.store/apps/{id}/environment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "env": {}
}'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({env: {}})
};

fetch('https://api.storiza.store/apps/{id}/environment', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.storiza.store/apps/{id}/environment"

payload = { "env": {} }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "message": "Environment updated",
  "data": {
    "id": "00000000-0000-4000-8000-000000000000",
    "name": "Survival",
    "hostname": "mc-survival",
    "type": "game_server",
    "owner": {
      "id": "00000000-0000-4000-8000-000000000000"
    },
    "subscription": {
      "id": "00000000-0000-4000-8000-000000000000"
    },
    "node": {
      "id": "00000000-0000-4000-8000-000000000000"
    },
    "template": {
      "id": "00000000-0000-4000-8000-000000000000"
    },
    "version": "latest",
    "plan": {
      "id": "00000000-0000-4000-8000-000000000000"
    },
    "group": null,
    "state": "running",
    "sftpUsername": "app-mc-survival",
    "createdAt": "2026-10-09T14:57:33.884Z"
  }
}

Authorizations

Authorization

string

header

required

An API key from the Storiza dashboard (API & Integrations), sent as Authorization: Bearer stz_….

Path Parameters

id

string<uuid>

required

Body

application/json

env

object

required

Show child attributes

Response

Environment updated

success

enum<boolean>

required

Available options:

true

message

enum<string>

required

Available options:

Environment updated

data

App · object

required

Schema for App model

Show child attributes

Example:

{
  "id": "00000000-0000-4000-8000-000000000000",
  "name": "Survival",
  "hostname": "mc-survival",
  "type": "game_server",
  "owner": {
    "id": "00000000-0000-4000-8000-000000000000"
  },
  "subscription": {
    "id": "00000000-0000-4000-8000-000000000000"
  },
  "node": {
    "id": "00000000-0000-4000-8000-000000000000"
  },
  "template": {
    "id": "00000000-0000-4000-8000-000000000000"
  },
  "version": "latest",
  "plan": {
    "id": "00000000-0000-4000-8000-000000000000"
  },
  "group": null,
  "state": "running",
  "sftpUsername": "app-mc-survival",
  "createdAt": "2026-10-09T14:57:33.884Z"
}