list_posts | Blogizi Docs

Lists posts for a project. Returns metadata only (no full markdown body) so agents can see what already exists before drafting.

Defaults to published posts. Pass status to include drafts or the schedule queue.

Arguments

status — optional. published (default), draft (unpublished without a future schedule), scheduled (draft with future scheduledAt), or all
limit — optional. Max posts to return (default 50, max 100)
projectSlug — required when the account has more than one blog

Example result

{
  "project": { "id": "665f…", "slug": "my-app" },
  "status": "published",
  "count": 2,
  "data": [
    {
      "id": "666a…",
      "title": "How we ship SEO posts",
      "slug": "how-we-ship-seo-posts",
      "description": "…",
      "keyword": "seo workflow",
      "status": "published",
      "coverImageUrl": "https://…",
      "publishedAt": "2026-10-01T12:00:00.000Z",
      "scheduledAt": null,
      "createdAt": "2026-09-28T09:00:00.000Z",
      "updatedAt": "2026-10-01T12:00:00.000Z"
    }
  ]
}

Use a returned slug with update_post, publish_post, schedule_post, or upload_post_image.