Advertisers

Advertisers running campaigns within a network

Delete an advertiser (privileged)

Permanently deletes the platform-wide advertiser document and responds 204. Requires the super_user role; ordinary network-scoped keys cannot delete advertisers. This is a hard delete of the advertiser record only — it does not cascade to campaigns that reference it. The delete is optimistic-locked, so a concurrent modification returns 409, and an advertiser id that does not exist returns 404.

List advertisers referenced by the network's campaigns

Returns a cursor-paginated page of advertisers, scoped to only those referenced by a campaign's advertiser_id in this network (platform-wide advertisers not used here are not exposed). Ordered by id; use the returned cursor for the next page. Requires the read_only network role.

Create an advertiser

Creates a platform-wide advertiser and returns it with a Location header. name and email are both required (otherwise 400). The advertiser becomes visible through this network's read endpoints only once a campaign in the network references it via advertiser_id. Requires the administrator network role.

Get an advertiser referenced by the network's campaigns

Returns a single advertiser, but only if it is referenced by at least one campaign in this network; otherwise 404 (even if the advertiser exists for another network). This is how a campaign's advertiser_id is resolved. Requires the read_only network role.

Update an advertiser's mutable business fields

Partial update: only the fields you send are changed. As with the read endpoints, the advertiser is addressable only if referenced by a campaign in this network; otherwise 404. The write is optimistic-locked, so a concurrent modification returns 409. Requires the administrator network role.