List All Global Variables

Get a paginated list of all global variables in your workspace.

The 200 response data is an array of variable summary objects. Each item includes name, dataType, value (masked as *** for secret variables), isSecret, canReset, checksum, createdAt, updatedAt. Pagination metadata (pageNo, pageSize, totalCount, totalPages) is returned at the top level.

List global variables

get

Get a paginated list of the global variables in your workspace, with optional filtering by name.

Response data is an array of variable objects. Each item includes id, name, dataType, value (masked as *** for secrets), isSecret, canReset, checksum, createdAt and updatedAt.

Pagination fields are returned at the top level: pageNo, pageSize, totalCount, totalPages.

Authorizations

Nected-API-KeystringRequired

Your Nected API key. Obtain from workspace settings.

Query parameters

pageNointegerOptional

Page number (1-based)

Default: 1

pageSizeintegerOptional

Items per page

Default: 10

namestringOptional

Filter variables by name

Header parameters

Nected-BranchstringOptional

Branch name (optional)

Responses

200

OK — paginated list of global variables

application/json

Response wrapper for the list endpoint

codestringOptionalExample: success

messagestringOptionalExample: Success.

pageNointegerOptionalExample: 1

pageSizeintegerOptionalExample: 10

totalCountintegerOptionalExample: 4

totalPagesintegerOptionalExample: 1

400

Bad Request

application/json

500

Internal Server Error

application/json

get/dev/v1/variable

GET /dev/v1/variable HTTP/1.1
Host: api.nected.ai
Nected-API-Key: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "id": "3f6c1e2a-8b4d-4c7e-9a10-5d2b7e8f9a01",
      "name": "tax_rate_gst",
      "dataType": "numeric",
      "value": 18,
      "isSecret": false,
      "canReset": true,
      "checksum": "a3f1b2c4d5e6f7a8b9c0d1e2f3a4b5c6",
      "createdAt": "2026-01-10T10:00:00.000Z",
      "updatedAt": "2026-04-22T08:30:00.000Z"
    },
    {
      "id": "7a9d2b4c-1e3f-4a5b-8c6d-0e1f2a3b4c5d",
      "name": "payment_gateway_url",
      "dataType": "string",
      "value": "https://gateway.example.com/v2/charge",
      "isSecret": false,
      "canReset": false,
      "checksum": "b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6",
      "createdAt": "2026-02-05T14:20:00.000Z",
      "updatedAt": "2026-02-05T14:20:00.000Z"
    },
    {
      "id": "9b8c7d6e-5f4a-4b3c-a2d1-e0f9a8b7c6d5",
      "name": "smtp_api_key",
      "dataType": "string",
      "value": "***",
      "isSecret": true,
      "canReset": false,
      "checksum": "c9d8e7f6a5b4c3d2e1f0a9b8c7d6e5f4",
      "createdAt": "2026-03-18T09:15:00.000Z",
      "updatedAt": "2026-05-01T11:00:00.000Z"
    },
    {
      "id": "1d2e3f4a-5b6c-4d7e-8f9a-0b1c2d3e4f5a",
      "name": "feature_flag_kyc",
      "dataType": "boolean",
      "value": true,
      "isSecret": false,
      "canReset": true,
      "checksum": "d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7",
      "createdAt": "2026-04-01T07:45:00.000Z",
      "updatedAt": "2026-05-20T16:00:00.000Z"
    }
  ],
  "code": "success",
  "message": "Success.",
  "pageNo": 1,
  "pageSize": 10,
  "totalCount": 4,
  "totalPages": 1
}