Environment Variables

API Reference for ProcessMaker Environment Variable API

Returns all environmentVariables that the user has access to. For security, values are not included.

get

Fetch a collection of variables based on paged request and filter if provided

Authorizations

passport & bearer

OAuth2authorizationCodeRequired

Laravel passport oauth2 security.

Authorization URL: Token URL: Refresh URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

filterstringOptional

Filter results by string. Searches Name, Description, and Status. Status must match exactly. Others can be a substring.

order_bystringOptional

Field to order results by

order_directionstring · enumOptionalDefault: ascPossible values:

per_pageintegerOptionalDefault: 10

includestringOptional

Include data from related models in payload. Comma separated list.

Default: ""

Responses

200

list of environmentVariables

application/json

get

/environment_variables

HTTPcURLJavaScriptPython

GET /api/1.0/environment_variables HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

list of environmentVariables

{
  "data": [
    {
      "name": "text",
      "description": "text",
      "value": "text",
      "id": 1,
      "created_at": "2026-01-07T12:43:49.983Z",
      "updated_at": "2026-01-07T12:43:49.983Z"
    }
  ],
  "meta": {}
}

Create a new environment variable

post

Creates a new global Environment Variable in the system

Authorizations

passport & bearer

OAuth2authorizationCodeRequired

Laravel passport oauth2 security.

Authorization URL: Token URL: Refresh URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

namestringOptional

descriptionstringOptional

valuestringOptional

Responses

201

success

application/json

post

/environment_variables

HTTPcURLJavaScriptPython

POST /api/1.0/environment_variables HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "name": "text",
  "description": "text",
  "value": "text"
}

201

success

{
  "name": "text",
  "description": "text",
  "value": "text",
  "id": 1,
  "created_at": "2026-01-07T12:43:49.983Z",
  "updated_at": "2026-01-07T12:43:49.983Z"
}

Get an environment variable by id. For security, the value is not included.

get

Return an environment variable instance Using implicit model binding, will automatically return 404 if variable now found

Authorizations

passport & bearer

OAuth2authorizationCodeRequired

Laravel passport oauth2 security.

Authorization URL: Token URL: Refresh URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

environment_variable_idintegerRequired

ID of environment_variables to return

Responses

201

success

application/json

get

/environment_variables/{environment_variable_id}

HTTPcURLJavaScriptPython

GET /api/1.0/environment_variables/{environment_variable_id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

201

success

{
  "name": "text",
  "description": "text",
  "value": "text",
  "id": 1,
  "created_at": "2026-01-07T12:43:49.983Z",
  "updated_at": "2026-01-07T12:43:49.983Z"
}

Update an environment variable

put

Update an environment variable

Authorizations

passport & bearer

OAuth2authorizationCodeRequired

Laravel passport oauth2 security.

Authorization URL: Token URL: Refresh URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

environment_variable_idintegerRequired

ID of environment variables to update

Body

application/json

namestringOptional

descriptionstringOptional

valuestringOptional

Responses

200

success

application/json

put

/environment_variables/{environment_variable_id}

HTTPcURLJavaScriptPython

PUT /api/1.0/environment_variables/{environment_variable_id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "name": "text",
  "description": "text",
  "value": "text"
}

200

success

{
  "name": "text",
  "description": "text",
  "value": "text",
  "id": 1,
  "created_at": "2026-01-07T12:43:49.983Z",
  "updated_at": "2026-01-07T12:43:49.983Z"
}

Delete an environment variable

delete

Authorizations

passport & bearer

OAuth2authorizationCodeRequired

Laravel passport oauth2 security.

Authorization URL: Token URL: Refresh URL:

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

environment_variable_idintegerRequired

ID of environment_variables to return

Responses

200

success

No content

delete

/environment_variables/{environment_variable_id}

HTTPcURLJavaScriptPython

DELETE /api/1.0/environment_variables/{environment_variable_id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

success

No content