API documentation

PUT /visitor_token_matchers/:id

Authorization Required

https://[your-subdomain].trackdrive.com/api/v1/visitor_token_matchers/:id

Update record by id.

Change the URL key or the internal token name on an existing visitor token matcher.

Params

Param name	Description
offer_id Optional Blank value allowed	Assign the record to this Offer. Must be a valid foreign key reference to an Offer. Refer to: /api/docs/1.0/offers
token Optional	The internal token name where values are stored. Must be a String
key Optional	This URL key will be assigned to a Trackdrive Token. Must be a String
sortable_order Optional Blank value allowed	The order in which records will be sorted. Values are sorted in ascending order; smaller values are listed first. Must be a decimal number.

Example Request

curl -X PUT 'https://[your-subdomain].trackdrive.com/api/v1/visitor_token_matchers/10001' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "token": "1e563464b25366fb087a2eb291663a65"
}'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "visitor_token_matcher": {
    "id": 10001,
    "type": "VisitorTokenMatcher",
    "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "created_at": "2026-01-15T15:30:00.000Z",
    "updated_at": "2026-01-15T15:30:00.000Z",
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": null,
    "routes_edit_path": null,
    "external_record_id": null,
    "offer_id": 10002,
    "token": "1e563464b25366fb087a2eb291663a65",
    "key": "example_visitor_key"
  },
  "metadata": {
    "root": "visitor_token_matcher"
  }
}