Skip to main content
PUT
/
advertisers
/
{advertiserId}
/
accounts
/
{linkId}
/
reporting-bucket
Update account reporting bucket
curl --request PUT \
  --url https://api.interchange.io/api/v2/buyer/advertisers/{advertiserId}/accounts/{linkId}/reporting-bucket \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reporting_bucket": {
    "protocol": "s3",
    "bucket": "my-org.adcp.reports",
    "file_retention_days": 30,
    "prefix": "reports/",
    "region": "us-east-1",
    "format": "jsonl",
    "compression": "gzip",
    "setup_instructions": "https://example.com/adcp/bucket-setup"
  }
}
'
{
  "account": {
    "linkId": "42",
    "accountId": "acc_acme_pinnacle",
    "sources": [
      {
        "storefrontId": 0,
        "storefrontName": "<string>",
        "sourceId": "<string>",
        "sourceName": "<string>"
      }
    ],
    "advertiserId": "12345",
    "createdAt": "2025-01-15T10:30:00Z",
    "updatedAt": "2025-01-20T14:45:00Z",
    "credentialId": "42",
    "name": "Acme c/o Pinnacle",
    "advertiser": "Acme Corp",
    "billingProxy": "Pinnacle Media",
    "house": "acme-corp.com",
    "billing": "advertiser"
  }
}

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"

Identifier of the advertiser-account link row (numeric primary key)

Pattern: ^\d+$
Example:

"42"

Body

application/json

Request body for updating the offline reporting bucket on a linked partner account

reporting_bucket
object
required

Reporting bucket configuration to set on the linked account, or null to clear it.

Response

Update account reporting bucket

Response containing a single linked account

account
object
required

Linked account resource on a partner platform