Networks
Networks (organizations) that own podcasts and campaigns
List networks the key can access
Returns the networks visible to the calling API key: a super-user key sees every network, while a scoped key sees only the networks listed in its scopes. Results are cursor-paginated and ordered by network id; pass the returned cursor to fetch the next page.
Create a network (privileged)
Creates a new network (organization). Requires the super_user role; ordinary network-scoped keys cannot create networks. The name, email, and a well-formed primary_contact are required. On success returns 201 with the created network and a Location header pointing at the new resource.
Get a network by id
Returns a single network's profile, including its contacts and email settings. Requires at least read-only access to the network. Responds with 404 if the network does not exist.
Delete a network (privileged)
Permanently deletes the network document and responds 204. Requires the super_user role; ordinary network-scoped keys cannot delete networks. This is a hard delete of the network record only — it does not cascade to the network's podcasts, campaigns, members, or other nested resources. The delete is optimistic-locked, so a concurrent modification returns 409, and a network id that does not exist returns 404.
Update a network's mutable business fields
Partially updates a network's business fields (name, email, description, website, default email language, and contacts); only the fields you supply are changed and the rest are left intact. Requires the administrator role on the network. The write is optimistically locked, so a concurrent modification returns 409.
Aggregate counts for a network
Returns live aggregate counts for the network: total and opted-in podcasts, total campaigns, total offers broken down by status (pending, accepted, rejected, negotiating), and total members. Requires at least read-only access. The counts are computed on demand by scanning the network's collections rather than read from denormalized counters, so this call is heavier than the other reads.