Link Settings API Reference

GET/v1/settings/link-setting/{id}Requires auth

#Get a link setting

#Parameters

path parameters

stringRequiredpath

#Response

200

Everything worked as expected.

linkSetting

object

Stores per-link compliance preferences that drive how Linkbreakers collects visitor data before executing the workflow.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

Example request (cURL)

curl -X GET "https://api.linkbreakers.com/v1/settings/link-setting/{id}" \
  -H "Authorization: Bearer YOUR_TOKEN"

Typical response

{
  "linkSetting": {
    "createdAt": "2025-10-08T16:55:07.354Z",
    "dataCollection": "DATA_COLLECTION_UNSPECIFIED",
    "id": "fbb5c4b6-2a10-4f35-8cb1-60c613a92d2a",
    "updatedAt": "2025-10-08T16:55:07.354Z"
  }
}

Base URL: https://api.linkbreakers.com

PUT/v1/settings/link-setting/{id}Requires auth

#Update a link setting

#Parameters

path parameters

stringRequiredpath

#Request body

dataCollection

string (enum)

Defines how aggressively Linkbreakers prompts visitors for identifying data before allowing the workflow to continue.

Allowed values

DATA_COLLECTION_UNSPECIFIED

Data collection preference not specified

DATA_COLLECTION_NONE

No visitor data captured; Linkbreakers only logs the scan event.

DATA_COLLECTION_BASIC

Minimal data prompts (e.g., email) enabled to keep friction low while identifying high-signal visitors.

DATA_COLLECTION_ADVANCED

Full lead capture flows, including custom forms and required fields, before continuing the workflow.