Skip to main content
PATCH /api/v2/buyer/advertisers/{advertiserId}/measurement-sources/{sourceId} Updates a measurement source. Send only the fields you want to change; omitted fields keep their current values. sourceKey is fixed at creation and cannot be changed here.

​
Request

curl -X PATCH https://api.interchange.io/api/v2/buyer/advertisers/12345/measurement-sources/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "paused",
    "signalWeight": 0.5,
    "lagWeeks": 2
  }'

​
Parameters

FieldTypeRequiredNotes
advertiserIdstringYesPath parameter — the owning advertiser
sourceIdstringYesPath parameter — the source ID
namestringNoHuman-readable label
outcomeTypestringNoPrimary outcome the source reports
outcomeTypesstring[]NoAdditional outcome types
granularitystringNoReporting grain (e.g. geo_week)
lagWeeksintegerNoExpected reporting lag in weeks
cadenceenumNocontinuous, daily, weekly, biweekly, monthly, quarterly
providerstringNoPartner name
ingestionMethodstringNoHow records arrive
attributionConfigobjectNoFree-form provider attribution settings
signalWeightnumberNoWeight in belief updates, 0–1
statusenumNopending, active, paused
notesstringNoFree-text notes

​
Response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "advertiserId": "12345",
  "sourceKey": "acme_incr_rev",
  "name": "Acme Incrementality",
  "outcomeType": "incremental_revenue",
  "outcomeTypes": [],
  "granularity": "geo_week",
  "cadence": "weekly",
  "provider": "acme-mmm",
  "lagWeeks": 2,
  "signalWeight": 0.5,
  "status": "paused",
  "createdAt": "2026-01-15T10:30:00Z",
  "updatedAt": "2026-03-20T14:45:00Z"
}
Returns the full source after the patch.

​
Errors

  • 400 VALIDATION_ERROR — invalid cadence/status or signalWeight outside 0–1.
  • 404 NOT_FOUND — sourceId (or advertiserId) does not exist or is not visible to the authenticated customer.
See Errors for the full error contract.

Measurement tasks

All measurement operations

Measurement overview

Pipeline, belief state, and concepts

Get measurement source

Read the current source