Skip to main content
GET
/
api
/
v2
/
public
/
env
/
values
/
:scope
curl -X GET "https://app.refold.ai/api/v2/public/env/values/linked_account?linked_account_id=YOUR_LINKED_ACCOUNT_ID" \
  -H "x-api-key: YOUR_API_KEY"

{
  "status": "success",
  "docs": [
    {
      "_id": "6a314b06d396207fd24fb16b",
      "variable_definition_id": {
        "_id": "6a1401de41e63efd08fb3e54",
        "name": "API_SECRET",
        "scope": "linked_account",
        "encrypted": true
      },
      "value": "[REDACTED]",
      "updatedAt": "2026-06-16T13:09:26.023Z"
    }
  ],
  "totalDocs": 1,
  "limit": 10,
  "page": 1
}
List the variable values for a given scope, paginated. Linked-account auth is restricted to its own scope; workflow scope requires a workflow_id. Encrypted values are redacted.

​
Authentication

This endpoint reads scoped values, so it accepts either authentication method. Option 1 — API key
​
x-api-key
string
Your Refold API key.
​
linked_account_id
string
Required (header or query) for the linked_account scope.
Option 2 — Session token
​
Authorization
string
Session token (restricted to the account’s own scope). Format: Bearer YOUR_SESSION_TOKEN

​
Path Parameters

​
scope
string
required
The scope to list: org, linked_account, or workflow.

​
Query Parameters

​
variable_definition_id
string
Filter to one definition.
​
linked_account_id
string
Required for linked_account scope.
​
workflow_id
string
Required for workflow scope.
​
page
integer
default:"1"
Page number.
​
limit
integer
default:"10"
Page size.

​
Response

​
status
string
success.
​
docs
array
Value documents. The variable_definition_id is populated with the definition.
​
totalDocs
integer
Total values in scope.
{
  "status": "success",
  "docs": [
    {
      "_id": "6a314b06d396207fd24fb16b",
      "variable_definition_id": {
        "_id": "6a1401de41e63efd08fb3e54",
        "name": "API_SECRET",
        "scope": "linked_account",
        "encrypted": true
      },
      "value": "[REDACTED]",
      "updatedAt": "2026-06-16T13:09:26.023Z"
    }
  ],
  "totalDocs": 1,
  "limit": 10,
  "page": 1
}

curl -X GET "https://app.refold.ai/api/v2/public/env/values/linked_account?linked_account_id=YOUR_LINKED_ACCOUNT_ID" \
  -H "x-api-key: YOUR_API_KEY"