Your first call

List the posts in your workspace, which is where every other call starts.

View as Markdown Open in Claude Open in ChatGPT

Listing posts is the natural first call: every other post endpoint needs an id, and this is where ids come from.

curl -H "Authorization: Bearer ptr_live_..." \
  "https://api.posttar.com/v1/posts?limit=2"

A real response, trimmed to two posts:

{
  "posts": [
    {
      "id": "8c64bee5-f756-47b7-a64a-01f5db597202",
      "status": "draft",
      "scheduledFor": null,
      "textContent": "Seu nicho pode estar amplo demais sem você perceber...",
      "projectId": "c85848ba-2881-4a2e-9bdd-841b26d07359",
      "contentFormat": "animated_audio",
      "theme": "Tres sinais de que o seu nicho esta amplo demais"
    }
  ],
  "next": "eyJjaGF2ZSI6IjIwMjYtMDktMTNUMDU6MTg6MDYuOTE4Njcz..."
}

Narrowing the list

Query parameter	What it does
`status`	Comma-separated: `draft,scheduled,published,failed,idea`
`from` and `to`	ISO dates, filtering by scheduled date
`projectId`	One project, when the workspace has more than one
`limit`	Default 25, max 100
`cursor`	The `next` value from the previous response

With from or to the list is ordered by scheduled date, ascending. Without them it is ordered by creation, newest first. It is the same rule the app's calendar uses.