List posts

The workspace's posts, newest first, 25 a page. Filter by status and platform. When nextCursor isn't null, pass it as cursor for the next page.

Request

curl -X GET "https://www.postel.app/api/v1/posts"

curl -X GET "https://www.postel.app/api/v1/posts"

Response

200

{
  "posts": [
    {
      "id": "cmhb0y2kq0003lb08m7d1c9va",
      "platform": "x",
      "status": "scheduled",
      "text": "Most launch posts fail for one reason.\n\nThey explain the product before the problem.",
      "thread": [
        "Most launch posts fail for one reason.",
        "They explain the product before the problem."
      ],
      "firstComment": null,
      "mediaCount": 0,
      "scheduledAt": "2026-11-05T09:30:00.000Z",
      "publishedAt": null,
      "url": null,
      "failure": null,
      "createdAt": "2026-11-03T09:14:02.000Z",
      "updatedAt": "2026-11-03T09:14:03.000Z"
    },
    {
      "id": "cmhb0x7rd0001lb08q2k5w3zt",
      "platform": "linkedin",
      "status": "draft",
      "text": "We shipped our public API today. Three things we learned building it:",
      "thread": [
        "We shipped our public API today. Three things we learned building it:"
      ],
      "firstComment": "Docs: https://www.postel.app/docs/api",
      "mediaCount": 0,
      "scheduledAt": null,
      "publishedAt": null,
      "url": null,
      "failure": null,
      "createdAt": "2026-11-03T09:12:44.000Z",
      "updatedAt": "2026-11-03T09:12:44.000Z"
    }
  ],
  "nextCursor": "cmhb0x7rd0001lb08q2k5w3zt"
}

Try it

Authorization

bearerAuth

AuthorizationBearer <token>

A Postel API key, Authorization: Bearer pstl_…. Create one in Postel under Settings → API & MCP; it acts for the workspace it was made in.

In: header

Query parameters

status?string

Only posts with this status

Value in"draft" | "scheduled" | "published" | "pending_approval"

platform?string

Only posts for this network

limit?integer

Posts per page, 1 to 100. Default 25

Range1 <= value <= 100

cursor?string

nextCursor from the previous page

Try it

Authorization

Query parameters

Responses

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

List posts

Try it

Authorization

Query parameters

Responses

200application/json

400application/json

401application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`