GET https://api.usecommune.com/newsletters/{newsletter}/threads Production. There is no separate sandbox host.

List a newsletter's threads

The conversations in this newsletter's community, most recently active first, ordered by last_activity_at descending.

A credential holding only read permissions sees threads whose visibility is public. One holding write in any family on the newsletter also sees subscribers threads, which are the ones a reader has to have joined the newsletter to read.

A private room is on the same side of that line. A thread scoped to subscriber segments (audience_scoped) is absent for a credential holding only read permissions and present for one holding write in any family, which acts for the newsletter's team, and the team can read every room. It is a third gate rather than a case of the first: a private thread can be public in its own right and is still withheld, and there is nothing in the response marking the rows the gate removed. Which segments it is private to is audience_tag_ids, which needs audience: read on top.

Threads opened by an article are included and carry is_article_thread as true. Filter them out with is_article_thread=false when you want only what people started themselves.

Path parameters

  • string Required

Query parameters

  • string
  • integer
  • string
  • string
  • string
  • boolean

Request Headers

  • string
GET /newsletters/{newsletter}/threads
Loading...

Share your request

Use this link to easily share a pre-filled request of this operation. Everything you filled will be shared apart from the authentication fields.

Request URL

https://api-reference.usecommune.dev/explorer/operation/operation-listnewsletterthreads

Send a delete request

It looks like you’re about to send a DELETE request to this API. This type of request carries a risk of permanent and irreversible data loss.

Are you sure you want to continue?
Response
Waiting for a request to be sent.