# Publishing (/docs/api/reference/publishing)



Two write endpoints kick off a publish: [`POST /v1/content/:containerId/publish`](/docs/api/reference/publishing/publish-content) sends now, [`POST /v1/content/:containerId/schedule`](/docs/api/reference/publishing/schedule-content) queues it for a `scheduledFor` timestamp. Both create the same `sp_<uuid>` post records — publish-now rows just have `scheduledFor` equal to the moment they were issued. Everything after that (get, list, reschedule, cancel) acts on those post records regardless of which endpoint created them.

If this is your first publish, start with [`publish-content`](/docs/api/reference/publishing/publish-content) — fewer fields to get right, immediate feedback. Layer in [`schedule-content`](/docs/api/reference/publishing/schedule-content) when you need to queue posts ahead of time.

## In this section [#in-this-section]

<Cards>
  <Card title="POST publish" href="/docs/api/reference/publishing/publish-content" description="Publish a container now. Atomic batch up to 50 targets." />

  <Card title="POST schedule" href="/docs/api/reference/publishing/schedule-content" description="Queue a container for a future scheduledFor. Same target shape as publish." />

  <Card title="GET post" href="/docs/api/reference/publishing/get-post" description="Read a single post by scheduledPostId. Polling cadence guidance." />

  <Card title="GET posts" href="/docs/api/reference/publishing/list-posts" description="List posts in a project. Filter by status, platform, time window." />

  <Card title="POST reschedule" href="/docs/api/reference/publishing/reschedule-post" description="Change scheduledFor on a queued post." />

  <Card title="DELETE cancel" href="/docs/api/reference/publishing/cancel-post" description="Cancel a queued post before it starts publishing." />

  <Card title="POST notify-device" href="/docs/api/reference/publishing/notify-device" description="SMS-to-device fallback when the creator finishes on-platform." />

  <Card title="GET tiktok-music" href="/docs/api/reference/publishing/list-tiktok-music" description="List TikTok-licensed tracks for the tiktokMusic.manual mode." />
</Cards>