Environment variable

List account variables

get

Returns all environment variables in the account scope (decrypted).

Authorizations

ApiKeyAuth

api-tokenstringRequired

Responses

200

Variables returned successfully

application/json

objectOptional

401

Authentication error

application/json

get/env/account

HTTPcURLJavaScriptPython

GET /v2/env/account HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "data": {
    "vars": {
      "API_KEY": "sk_live_123",
      "NODE_ENV": "production"
    }
  }
}

Replace account variables

put

Replaces the entire set of environment variables in the account scope.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Body

application/json

Responses

200

Variables saved successfully

application/json

objectOptional

400

Invalid variables

application/json

401

Authentication error

application/json

put/env/account

HTTPcURLJavaScriptPython

PUT /v2/env/account HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 58

{
  "vars": {
    "API_KEY": "sk_live_123",
    "NODE_ENV": "production"
  }
}

{
  "status": "ok",
  "data": {
    "vars": {
      "API_KEY": "sk_live_123",
      "NODE_ENV": "production"
    }
  }
}

Remove account variables

delete

Removes all environment variables in the account scope.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Responses

200

Variables removed successfully

application/json

objectOptional

401

Authentication error

application/json

delete/env/account

HTTPcURLJavaScriptPython

DELETE /v2/env/account HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "data": {
    "removed": 2
  }
}

List project variables

get

Returns the environment variables of a project (decrypted). Requires project management permission.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

projectIDstringRequired

Project ID

Responses

200

Variables returned successfully

application/json

objectOptional

401

Authentication error

application/json

403

No permission to access the project

application/json

404

Project not found

application/json

get/env/project/{projectID}

HTTPcURLJavaScriptPython

GET /v2/env/project/{projectID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "data": {
    "vars": {
      "DATABASE_URL": "postgres://..."
    }
  }
}

Replace project variables

put

Replaces the entire set of environment variables of a project.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

projectIDstringRequired

Project ID

Body

application/json

Responses

200

Variables saved successfully

application/json

objectOptional

400

Invalid variables

application/json

401

Authentication error

application/json

403

No permission to manage the project

application/json

404

Project not found

application/json

put/env/project/{projectID}

HTTPcURLJavaScriptPython

PUT /v2/env/project/{projectID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "vars": {
    "DATABASE_URL": "postgres://..."
  }
}

{
  "status": "ok",
  "data": {
    "vars": {
      "DATABASE_URL": "postgres://..."
    }
  }
}

Remove project variables

delete

Removes all environment variables of a project.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

projectIDstringRequired

Project ID

Responses

200

Variables removed successfully

application/json

objectOptional

401

Authentication error

application/json

403

No permission to manage the project

application/json

404

Project not found

application/json

delete/env/project/{projectID}

HTTPcURLJavaScriptPython

DELETE /v2/env/project/{projectID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "data": {
    "removed": 1
  }
}

List app variables

get

Returns the environment variables of an app (decrypted). Requires config_app permission.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

appIDstringRequired

Application ID

Responses

200

Variables returned successfully

application/json

objectOptional

401

Authentication error

application/json

403

No permission to access the app

application/json

404

Application not found

application/json

get/env/app/{appID}

HTTPcURLJavaScriptPython

GET /v2/env/app/{appID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "data": {
    "vars": {
      "TOKEN": "abc123"
    }
  }
}

Replace app variables

put

Replaces the entire set of environment variables of an app.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

appIDstringRequired

Application ID

Body

application/json

Responses

200

Variables saved successfully

application/json

objectOptional

400

Invalid variables

application/json

401

Authentication error

application/json

403

No permission to manage the app

application/json

404

Application not found

application/json

put/env/app/{appID}

HTTPcURLJavaScriptPython

PUT /v2/env/app/{appID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 27

{
  "vars": {
    "TOKEN": "abc123"
  }
}

{
  "status": "ok",
  "data": {
    "vars": {
      "TOKEN": "abc123"
    }
  }
}

Remove app variables

delete

Removes all environment variables of an app.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

appIDstringRequired

Application ID

Responses

200

Variables removed successfully

application/json

objectOptional

401

Authentication error

application/json

403

No permission to manage the app

application/json

404

Application not found

application/json

delete/env/app/{appID}

HTTPcURLJavaScriptPython

DELETE /v2/env/app/{appID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "data": {
    "removed": 1
  }
}