Application Environment Variables API Endpoints

Learn more about how to view, add, connect and destroy application domains with our API

Get Environment Variables

To list all existing environment variable of an app you can simply send a GET request to the following endpoint.

https://api.nodion.com/v1/applications/:id/env_variables

Required Headers: Authorization

Example Response:

{
  "env_variables": [
    {
      "id": "0cff843a-2487-4fba-9e50-fb4ef68191e2",
      "env_key": "NODION_DOCKERFILE_PATH",
      "env_val": "Dockerfile.test",
      "buildtime": false,
      "created_at": "2025-06-01T17:00:34.142+01:00",
      "updated_at": "2024-06-01T17:00:34.142+01:00"
    },
    {
      "id": "7b15b189-9523-40e9-8df2-efaf2e680191",
      "env_key": "TEST123",
      "env_val": "ok",
      "buildtime": false,
      "created_at": "2025-06-01T17:00:34.142+01:00",
      "updated_at": "2024-06-01T17:00:34.142+01:00"
    }
  ]
}

Get Environment Variable

To get a single environment variable of an app you can simply send a GET request to the following endpoint.

https://api.nodion.com/v1/applications/:id/env_variables/:env_variable_id

Required Headers: Authorization

Example Response:

{
  "env_variable": {
    "id": "0cff843a-2487-4fba-9e50-fb4ef68191e2",
    "env_key": "NODION_DOCKERFILE_PATH",
    "env_val": "Dockerfile.test",
    "buildtime": false,
    "created_at": "2025-06-01T17:00:34.142+01:00",
    "updated_at": "2024-06-01T17:00:34.142+01:00"
  }
}

Create Environment Variable

To create a new environment variable within that app you can send a POST request to the following endpoint.

https://api.nodion.com/v1/applications/:id/env_variables

Required Headers: Authorization

Required Body Parameters:

env_key – The key of that environment variable.

env_val – The value of that environment variable.

Optional Body Parameters:

buildtime – true or false if the env var should be set when the container is being built.

Possible Response Codes:

200 – The environment variable was created successfully.
400 – Please check the response body for more details.

Example Response:

{
  "env_variable": {
    "id": "0cff843a-2487-4fba-9e50-fb4ef68191e2",
    "env_key": "NODION_DOCKERFILE_PATH",
    "env_val": "Dockerfile.test",
    "buildtime": false,
    "created_at": "2025-06-01T17:00:34.142+01:00",
    "updated_at": "2024-06-01T17:00:34.142+01:00"
  }
}

Update Environment Variable

To update an existing environment variable within that app you can send a PATCH request to the following endpoint.

https://api.nodion.com/v1/applications/:id/env_variables/:env_variable_id

Required Headers: Authorization

Possible Body Parameters:

env_key – The key of that environment variable.

env_val – The value of that environment variable.

buildtime – true or false if the env var should be set when the container is being built.

Possible Response Codes:

200 – The environment variable was updated.
400 – Please check the response body for more details.

Example Response:

{
  "env_variable": {
    "id": "0cff843a-2487-4fba-9e50-fb4ef68191e2",
    "env_key": "NODION_DOCKERFILE_PATH",
    "env_val": "Dockerfile.test",
    "buildtime": true,
    "created_at": "2025-06-01T17:00:34.142+01:00",
    "updated_at": "2024-06-01T17:00:34.142+01:00"
  }
}

Delete Environment Variable

To delete an existing environment variable within that app you can send a DELETE request to the following endpoint.

https://api.nodion.com/v1/applications/:id/env_variables/:env_variable_id

Required Headers: Authorization

Possible Response Codes:

200 – The environment variable was deleted.
400 – Please check the response body for more details.

Example Response:

{
  "deleted": true
}