EnvironmentVariables

List Environment Variables

get
Authorizations
Query parameters
PageNumberinteger · int32Optional

Current page number. Default value is 1.

PageSizeinteger · int32Optional

Maximum page size is 200. Default page size is 30.

environmentVariableNamestringOptional

Name of the Environment Variable(s)

Responses
200

OK

application/json
get
/api/v1/environment-variables
GET /api/v1/environment-variables HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
200

OK

{
  "data": [
    {
      "id": 1,
      "name": "text",
      "type": "String",
      "values": [
        {
          "value": [
            "[Circular Reference]"
          ],
          "modifiedUtc": "2025-10-17T20:23:31.028Z",
          "modifier": "text",
          "version": 1,
          "environment": {
            "id": 1,
            "displayName": "text"
          }
        }
      ],
      "description": null,
      "childSchemas": [
        {
          "id": 1,
          "name": "text",
          "type": "String",
          "values": [
            "[Circular Reference]"
          ]
        }
      ]
    }
  ],
  "paging": {
    "currentPage": 1,
    "pageSize": 1,
    "totalCount": 1,
    "firstPage": "https://example.com",
    "lastPage": "https://example.com",
    "nextPage": "https://example.com",
    "previousPage": "https://example.com"
  }
}

Add Environment Variable

post
Authorizations
Body
namestringOptional
Responses
201

Successful request

Responseinteger · int64
post
/api/v1/environment-variables
POST /api/v1/environment-variables HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "name": "text"
}
201

Successful request

1

Get an Environment Variable

get
Authorizations
Path parameters
idinteger · int64Required

Id of the Environment Variable

Responses
200

Successful request

application/json
get
/api/v1/environment-variables/{id}
GET /api/v1/environment-variables/{id} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
{
  "data": {
    "id": 1,
    "name": "text",
    "type": "String",
    "values": [
      {
        "value": [
          [
            "[Circular Reference]"
          ]
        ],
        "modifiedUtc": "2025-10-17T20:23:31.028Z",
        "modifier": "text",
        "version": 1,
        "environment": {
          "id": 1,
          "displayName": "text"
        }
      }
    ],
    "description": null,
    "childSchemas": [
      {
        "id": 1,
        "name": "text",
        "type": "String",
        "values": [
          {
            "value": "[Circular Reference]",
            "modifiedUtc": "2025-10-17T20:23:31.028Z",
            "modifier": "text",
            "version": 1,
            "environment": {
              "id": 1,
              "displayName": "text"
            }
          }
        ]
      }
    ]
  }
}

Create child Environment Variable

post
Authorizations
Path parameters
rootSchemaIdinteger · int64Required

Id of the parent Environment Variable schema.

Body
namestringOptional
typestring · enumOptionalPossible values:
Responses
201

Child Environment Variable created successfully.

text/plain
Responseinteger · int64
post
/api/v1/environment-variables/{rootSchemaId}
POST /api/v1/environment-variables/{rootSchemaId} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 31

{
  "name": "text",
  "type": "String"
}
1

Delete Environment Variable

delete
Authorizations
Path parameters
schemaIdinteger · int64Required
Responses
204

Environment Variable deleted successfully.

No content

delete
/api/v1/environment-variables/{schemaId}
DELETE /api/v1/environment-variables/{schemaId} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

No content

Update the description of an Environment Variable.

patch
Authorizations
Path parameters
schemaIdinteger · int64Required

Identifier of the Environment Variable being updated.

Body

New description.

descriptionstring · min: 1Optional
Responses
204

Environment Variable description updated successfully.

No content

patch
/api/v1/environment-variables/{schemaId}
PATCH /api/v1/environment-variables/{schemaId} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "description": "text"
}

No content

Update Environment Variable

put
Authorizations
Path parameters
schemaIdinteger · int64Required

Identifier of the Environment Variable being updated.

environmentIdinteger · int64Required

Identifier of the Environment being updated.

Bodyobject[]
object[]Optional
Responses
204

Environment Variable updated successfully.

No content

put
/api/v1/environment-variables/{schemaId}/values/{environmentId}
PUT /api/v1/environment-variables/{schemaId}/values/{environmentId} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 4

[
  {}
]

No content

Was this helpful?