Publish a completed clip to explicitly named destinations (explicit user confirmation required)

Publishing is a real-world action. Before this call, show the user every exact destination, the final title/description, and visibility, then obtain an explicit go-ahead. Omitted destinations never mean all accounts.

post/api/v1/publish

Request

  • Base URL: https://everpop.app
  • URL: https://everpop.app/api/v1/publish
  • Auth: HTTP bearer

Request body

clipIdstring required
destinationIdsstring[] required

Exact ids returned by GET /api/v1/publish

Response

One result per destination; ok:true only means the request was taken. Check every posts[].status and errorCode: PUBLISHED and DELIVERED went out, FAILED and CONFLICT did not, DISMISSED was discarded; the rest are still in flight — follow them with GET /api/v1/posts?clipId=. A post still in flight that carries errorMessage is held: relay the message to the user instead of polling it.

okunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.