Podcasts

Podcasts owned by a network

List podcasts in a network

Requires the read_only role on the network. Returns a cursor-paginated page; pass the returned cursor back as ?cursor to fetch the next page and ?limit to size it. Add ?expand=primary_voice to inline each podcast's platform-assigned primary voice when one is set.

Create a podcast in a network

Requires the administrator role on the network. title, feed_url, and a valid primary_contact are mandatory. Platform-owned fields (opt_in_status, primary_voice_id) cannot be set here. Responds 201 with the created podcast and a Location header pointing at its by-id resource.

Get a podcast by id

The network is resolved from the podcast document and the caller must hold the read_only role on that network (403 otherwise, 404 if no such podcast). Add ?expand=primary_voice to inline the podcast's primary voice when one is set.

Delete a podcast

The network is resolved from the podcast document and the caller must hold the administrator role on that network (403 otherwise, 404 if no such podcast). Permanently deletes the podcast document and responds 204. This is a hard delete of the podcast record only — it does not cascade to the podcast's voices, creatives, or other nested resources. The delete is optimistic-locked, so a concurrent modification returns 409.

Update a podcast's mutable business fields

The network is resolved from the podcast document and the caller must hold the administrator role on it. This is a partial update: only the fields present in the body are changed, and platform-owned fields are never accepted. The write is optimistic-locked, so a concurrent modification returns 409.