Get Variable Definition

Get an environment-variable definition by ID.

GET /api/v2/public/env/definitions/:id

cURL

curl -X GET "https://app.refold.ai/api/v2/public/env/definitions/{id}" \
  -H "x-api-key: YOUR_API_KEY"

200

{
  "definition": {
    "_id": "6a159a9741e63efd0833773f",
    "org_id": "6500a1b2c3d4e5f6a7b8c9d0",
    "name": "API_BASE_URL",
    "description": "Base URL for callbacks",
    "scope": "org",
    "var_format": "string",
    "encrypted": false,
    "created_at": "2026-05-26T13:05:27.782Z",
    "updated_at": "2026-05-26T13:05:27.782Z"
  }
}

Get a single environment-variable definition by its ID. The definition is returned wrapped in a definition object.

Authentication

Definitions are org-level, so this endpoint uses API-key auth.

x-api-key · string · required

Your Refold API key.

Path Parameters

id · string · required

The definition ID.

Response

200 OK

definition · object

The variable definition.

Show properties

_id · string

Definition ID.

name · string

Variable name.

scope · string

org, linked_account, or workflow.

var_format · string

Value format.

encrypted · boolean

Whether values are stored encrypted.

404 Not Found

status_code · integer

HTTP status code.

http_error_type · string

Error category.

error_code · string

Internal error code, e.g. RESOURCE_NOT_FOUND.

message · string

Human-readable error description.

200

{
  "definition": {
    "_id": "6a159a9741e63efd0833773f",
    "org_id": "6500a1b2c3d4e5f6a7b8c9d0",
    "name": "API_BASE_URL",
    "description": "Base URL for callbacks",
    "scope": "org",
    "var_format": "string",
    "encrypted": false,
    "created_at": "2026-05-26T13:05:27.782Z",
    "updated_at": "2026-05-26T13:05:27.782Z"
  }
}

cURL

curl -X GET "https://app.refold.ai/api/v2/public/env/definitions/{id}" \
  -H "x-api-key: YOUR_API_KEY"