Skip to main content
PUT
/
api
/
v2
/
public
/
config
/
field
/
:fieldId
curl -X PUT "https://app.refold.ai/api/v2/public/config/field/{fieldId}" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID" \
  -H "slug: {slug}" \
  -H "Content-Type: application/json" \
  -d '{ "value": ["A", "B"] }'

{
  "id": "699fec7a5bd27ed2af7243ad",
  "name": "Select",
  "field_type": "select",
  "multiple": true,
  "options": [
    { "name": "A", "value": "A" },
    { "name": "B", "value": "B" },
    { "name": "C", "value": "C" }
  ],
  "value": ["A", "B"]
}
Set the value for a single config field, optionally scoped to a specific workflow. The config must already be installed for the linked account (see Get or Create Config).

​
Authentication

This endpoint is scoped to a linked account, so it accepts either authentication method. Option 1 — API key
​
x-api-key
string
Your Refold API key.
​
linked_account_id
string
The linked account.
Option 2 — Session token
​
Authorization
string
Session token. Format: Bearer YOUR_SESSION_TOKEN

​
Headers

​
slug
string
required
The app slug. Example: hubspot

​
Path Parameters

​
fieldId
string
required
The field ID to set.

​
Query Parameters

​
config_id
string
Config to scope to. Defaults to the linked account’s config.
​
workflow_id
string
Scope the value to a specific workflow.

​
Body Parameters

​
value
any
required
The value to set. Shape depends on the field type (e.g. an array for a multi-select).

​
Response

Returns the field with its new value.
{
  "id": "699fec7a5bd27ed2af7243ad",
  "name": "Select",
  "field_type": "select",
  "multiple": true,
  "options": [
    { "name": "A", "value": "A" },
    { "name": "B", "value": "B" },
    { "name": "C", "value": "C" }
  ],
  "value": ["A", "B"]
}

curl -X PUT "https://app.refold.ai/api/v2/public/config/field/{fieldId}" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID" \
  -H "slug: {slug}" \
  -H "Content-Type: application/json" \
  -d '{ "value": ["A", "B"] }'