Skip to main content
PUT /api/v2/buyer/advertisers/{advertiserId}/property-lists/{listId} Updates a list’s name and/or replaces its identifiers. There is no incremental add/remove — when you send domains or identifiers, the full set is replaced with what you submit. Updating an include list cascades to active media buys that reference it.

​
Request

curl -X PUT https://api.interchange.io/api/v2/buyer/advertisers/12345/property-lists/42 \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "identifiers": [
      { "type": "domain", "value": "example-times.com" },
      { "type": "ios_bundle", "value": "com.exampletimes.ExampleTimes" }
    ]
  }'

​
Parameters

FieldTypeRequiredNotes
advertiserIdstringYesPath. Owning advertiser
listIdstringYesPath. The property list to update
namestringNoUpdated name (1–255 chars)
domainsstring[]NoReplacement domains shorthand. Up to 100,000
identifiersobject[]NoReplacement typed { type, value } set. Up to 100,000
Send at least one field. Providing domains and/or identifiers replaces the entire identifier set; pass the full union you want stored.

​
Response

{
  "propertyList": {
    "listId": "42",
    "name": "Q1 Campaign - UK Premium",
    "purpose": "include",
    "identifiers": [
      { "type": "domain", "value": "example-times.com" },
      { "type": "ios_bundle", "value": "com.exampletimes.ExampleTimes" }
    ],
    "unresolvedIdentifiers": [],
    "registeredIdentifiers": [],
    "domains": ["example-times.com"],
    "propertyCount": 12,
    "resolutionSummary": {
      "totalRequested": 2,
      "resolvedCount": 2,
      "registeredCount": 0,
      "unresolvedCount": 0,
      "resolutionRate": 1
    },
    "cascadeSummary": {
      "totalMediaBuys": 4,
      "updatedCount": 3,
      "failedCount": 1
    },
    "updatedAt": "2026-01-20T14:45:00.000Z"
  }
}
resolutionSummary and cascadeSummary appear only when identifiers change — a name-only update returns neither. The cascade is best-effort: failures are logged for retry and do not roll back the update.

​
Errors

  • 400 VALIDATION_ERROR — no fields supplied, or combined identifier total above 100,000.
  • 404 NOT_FOUND — listId or advertiserId does not exist or is not visible to the authenticated customer.
See Errors for the full error contract.

Property list tasks

All property list operations

Property Lists guide

Cascade behavior and resolution concepts

Get property list

Full resolved resource for one list

Check property list

Validate a candidate set before replacing