List Drafts

List your post drafts, optionally filtered by status. Requires a paid Creator or Lifetime plan.

GET /v1/posts lists the account's post drafts. With no query string you get everything the Studio holds; pass status to narrow to draft, scheduled or published. The response is a flat array in data with meta.count alongside it.

Use this to reconcile an external content calendar with LinkedMash, or to find the draft ids you need for the schedule and update endpoints when you did not keep them from the create call.

Example request

Authenticate with a bearer token in the Authorization header. Create a key on the API page in your LinkedMash settings and export it as LINKEDMASH_API_KEY before running this.

curl "https://api.linkedmash.com/v1/posts?status=draft" \
  -H "Authorization: Bearer $LINKEDMASH_API_KEY"

Header parameters

Query parameters

Combine these parameters to narrow your results.

Response

{
  "status": true,
  "data": [
    {
      "id": "drf_8f3a21c9",
      "content": "5 lessons from shipping every week for a year:",
      "title": "Weekly shipping lessons",
      "format": "text",
      "status": "draft",
      "created_at": "2026-06-22T09:14:02.118Z",
      "updated_at": "2026-06-22T09:14:02.118Z"
    }
  ],
  "meta": {
    "count": 1
  }
}