Update account reporting bucket

PUT /api/v2/buyer/advertisers/{advertiserId}/accounts/{linkId}/reporting-bucket Sets or clears the offline reporting_bucket configuration on a linked partner account, then notifies the seller via sync_accounts. The bucket is where sales agents write offline delivery reports.

Request

curl -X PUT https://api.interchange.io/api/v2/buyer/advertisers/12345/accounts/42/reporting-bucket \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reporting_bucket": {
      "protocol": "gcs",
      "bucket": "acme-adcp-reports",
      "prefix": "reports/",
      "region": "us-east-1",
      "format": "jsonl",
      "compression": "gzip",
      "file_retention_days": 30
    }
  }'

{
  "reporting_bucket": null
}

Parameters

Field	Type	Required	Notes
`advertiserId`	string (path)	Yes	Unique identifier for the advertiser
`linkId`	string (path)	Yes	Numeric ID of the advertiser-account link row
`reporting_bucket`	object \| null	Yes	Bucket config, or `null` to clear
`reporting_bucket.protocol`	enum	Yes*	`s3`, `gcs`, or `azure_blob`
`reporting_bucket.bucket`	string	Yes*	Bucket name (3–63 chars; lowercase alphanumerics, dots, hyphens)
`reporting_bucket.file_retention_days`	integer	Yes*	Days the buyer retains report files (min 1)
`reporting_bucket.prefix`	string	No	Object key prefix within the bucket
`reporting_bucket.region`	string	No	Storage region (e.g. `us-east-1`)
`reporting_bucket.format`	enum	No	`jsonl` (default), `csv`, `parquet`, `avro`, or `orc`
`reporting_bucket.compression`	enum	No	`gzip` (default) or `none`
`reporting_bucket.setup_instructions`	string (URL)	No	HTTPS URL pointing to setup instructions for granting the agent access to the bucket

* Required only when reporting_bucket is an object.

Response

{
  "linkId": "42",
  "accountId": "acc_example_pinnacle",
  "name": "Example Corp c/o Pinnacle",
  "advertiser": "Example Corp",
  "billingProxy": null,
  "house": null,
  "billing": "advertiser",
  "sources": [{ "storefrontId": 42, "storefrontName": "Example Publisher", "sourceId": "src_main", "sourceName": "Main Feed" }],
  "advertiserId": "12345",
  "status": "active",
  "createdAt": "2025-01-15T10:30:00Z",
  "updatedAt": "2025-01-20T14:45:00Z"
}

Returns the updated linked account. The seller is notified of the bucket change automatically.

Errors

400 VALIDATION_ERROR — malformed bucket name, unsupported protocol, or missing file_retention_days.
404 NOT_FOUND — advertiserId or linkId does not exist or is not visible.

See Errors for the full error contract.

Advertiser tasks

All advertiser operations

Advertiser overview

Linked accounts model

List available accounts

Find the account to configure

Revalidate delivery credential

Re-probe delivery access

Getting Started

Advertisers

Campaigns

Product Discovery

Webhooks

Creatives

Signals & Brand

Audiences & Inventory

Measurement & Conversions

Reporting & Activity

Planning & Governance

Connections

Account & Billing

Update account reporting bucket

Request

Parameters

Response

Errors

Advertiser tasks

Advertiser overview

List available accounts

Revalidate delivery credential

​Request

​Parameters

​Response

​Errors

​Related

Advertiser tasks

Advertiser overview

List available accounts

Revalidate delivery credential

Request

Parameters

Response

Errors

Related