POST https://api.usecommune.com/threads/{thread}/publish Production. There is no separate sandbox host.

Put a thread on the global feed

Promotes a thread from the newsletter's own space to Commune's global feed, where anyone can read it. Needs content: write. One thread at a time: there is no automatic promotion and no bulk form.

It is not reversible through this API. A thread can be taken back off the feed in Commune itself, but no operation here does it. Treat the promotion as a decision rather than a toggle.

A thread that is already public is a success rather than a conflict, changes nothing, and publishes no event.

Replies are not threads and answer 422. A reply is exactly as readable as the thread it is in, so promote the thread instead.

A thread scoped to subscriber segments answers 422 as well. It is a private room, the people in it wrote for an audience that was named when the conversation started, and promoting it would publish those words to everybody. Clear the audience first with PATCH /threads/{thread}, which is a deliberate widening and asks for confirm_widening, and then publish it.

Takes no body: there is only one visibility this moves a thread to.

Publishes thread.published, carrying the visibility the thread had before, unless it was already public.

Path parameters

  • string Required

Request Headers

  • string
  • string Required
POST /threads/{thread}/publish
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-publishthread

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.