Skip to main content
PUT
/
advertisers
/
{advertiserId}
/
property-lists
/
{listId}
Update property list
curl --request PUT \
  --url https://api.interchange.io/api/v2/buyer/advertisers/{advertiserId}/property-lists/{listId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "propertyList": {
    "listId": "42",
    "name": "Q1 Campaign - UK Premium",
    "purpose": "include",
    "identifiers": [
      {
        "type": "domain",
        "value": "<string>"
      }
    ],
    "unresolvedIdentifiers": [
      {
        "type": "domain",
        "value": "<string>"
      }
    ],
    "registeredIdentifiers": [
      {
        "type": "domain",
        "value": "<string>"
      }
    ],
    "domains": [
      "<string>"
    ],
    "unresolvedDomains": [
      "<string>"
    ],
    "registeredDomains": [
      "<string>"
    ],
    "propertyCount": 25,
    "createdAt": "2026-01-15T10:30:00.000Z",
    "updatedAt": "2026-01-20T14:45:00.000Z",
    "resolutionSummary": {
      "totalRequested": 500,
      "resolvedCount": 432,
      "registeredCount": 12,
      "unresolvedCount": 56,
      "resolutionRate": 0.864
    },
    "cascadeSummary": {
      "totalMediaBuys": 4,
      "updatedCount": 3,
      "failedCount": 1
    },
    "filters": {
      "channels_any": [
        "display",
        "olv"
      ],
      "countries_all": [
        "US",
        "GB"
      ],
      "property_types": [
        "website"
      ],
      "feature_requirements": [
        {
          "feature_id": "<string>",
          "min_value": 123,
          "max_value": 123,
          "allowed_values": [
            "<unknown>"
          ],
          "if_not_covered": "exclude"
        }
      ]
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.agentic.scope3.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

advertiserId
string
required

Unique identifier for the advertiser

Minimum string length: 1
Example:

"12345"

listId
string
required

Body

application/json

Request body for updating a property list

name
string

Updated name for the property list

Required string length: 1 - 255
domains
string[]

Updated domain list (convenience shorthand for identifiers with type: "domain"). If provided together with identifiers, both are merged. Replaces the existing identifier set entirely. Large lists are chunked server-side; the response includes a resolutionSummary with the counts.

Maximum array length: 100000
Minimum string length: 1
identifiers
object[]

Updated typed identifiers (domains + bundles). Replaces the existing identifier set entirely when either domains or identifiers is provided.

Maximum array length: 100000

Response

Update property list

Response containing a single property list

propertyList
object
required

Property list resource representation