PUT/v1/preferenceagents/{id}

Update preferenceagents

Not yet documented — no summary in the API source.

RequiresAuthorization: Bearer sk_...tenant_id

Path parameters

idstringrequired

Request body application/json

idstringnullable
tenant_idstringnullable
created_atstring (date-time)
updated_atstring (date-time)
namestringnullablemax length 64
descriptionstringnullablemax length 512
businessUnitstringnullable
slugstringnullable
statusstringnullable
redirectUrlstringnullable
welcomestringnullable
farewellstringnullable
elementsarray of objectPreferenceAgentElementnullable
idstringnullable
groupstringnullable
refIdstringnullable
askstringnullable
requiredboolean
confirmboolean
orderinteger (int32)
resolvedNamestringnullable
resolvedLabelstringnullable
resolvedDescriptionstringnullable
resolvedTypestringnullable
resolvedChannelsIdsarray of stringnullable
resolvedFrequenciesIdsarray of stringnullable
orphanedboolean
accentstringnullable
avatarstringnullable
bubblestringnullable
densitystringnullable
showProgressboolean
showCountboolean
tonestringnullable
languagestringnullable
stayOnTopicboolean
allowSkipboolean
allowLookupboolean
allowUnsubscribeboolean
writeContactboolean
createContactboolean
fallbackPageIdstringnullable
is_deletedboolean
deleted_atstring (date-time)nullable

Responses

No response body.

curl --request PUT \
  --url 'https://api.4comply.io/v1/preferenceagents/00000000-0000-0000-0000-000000000000' \
  --header 'Authorization: Bearer sk_...' \
  --header 'tenant_id: your-tenant-id' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "00000000-0000-0000-0000-000000000000",
  "tenant_id": "your-tenant-id",
  "created_at": "2026-09-07T12:00:00Z",
  "updated_at": "2026-09-07T12:00:00Z",
  "name": "Example name",
  "description": "Example text",
  "businessUnit": "string",
  "slug": "example-slug",
  "status": "active",
  "redirectUrl": "https://example.com",
  "welcome": "string",
  "farewell": "string",
  "elements": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "group": "string",
      "refId": "00000000-0000-0000-0000-000000000000",
      "ask": "string",
      "required": true,
      "confirm": true,
      "order": 1,
      "resolvedName": "Example name",
      "resolvedLabel": "string",
      "resolvedDescription": "string",
      "resolvedType": "string",
      "resolvedChannelsIds": [
        "string"
      ],
      "resolvedFrequenciesIds": [
        "string"
      ],
      "orphaned": true
    }
  ],
  "design": {
    "accent": "string",
    "avatar": "string",
    "bubble": "string",
    "density": "string",
    "showProgress": true,
    "showCount": true
  },
  "behavior": {
    "tone": "string",
    "language": "en",
    "stayOnTopic": true,
    "allowSkip": true,
    "allowLookup": true,
    "allowUnsubscribe": true
  },
  "data": {
    "writeContact": true,
    "createContact": true,
    "fallbackPageId": "00000000-0000-0000-0000-000000000000"
  },
  "is_deleted": true,
  "deleted_at": "2026-09-07T12:00:00Z"
}'