---
title: "List posts"
method: POST
path: "/list_posts"
tags: ["Read"]
---

# List posts

`POST /list_posts`

## Request

- Base URL: `https://pdb.postpen.ai/functions/v1/agent-api`
- URL: `https://pdb.postpen.ai/functions/v1/agent-api/list_posts`
- Auth: HTTP bearer

Lists this account’s drafts, scheduled posts, or sent posts. Each row includes has_media, media_count, media_type (photo, video, or pdf), and media_urls stored on the content row, which show whether media is attached, plus first_comment and auto_react when set, and mentions (the company pages tagged in the text).

## Request body

- object
  - `status` 'draft' | 'scheduled' | 'sent', required: Which queue to read.
  - `limit` integer: How many rows to return. Defaults to 50.

## Response `200`

Success. JSON object; never contains LinkedIn tokens.

- object

## Other responses

- `400`: Invalid input, or a confirm: true guard was not met.
- `401`: Missing or invalid API key.
- `402`: Plan limit reached (for example the Free plan's monthly post cap).
- `403`: Destination not allowed for this account or plan.

---

[API](https://skmtc.dev/postpen/apis/postpen-agent-api.md) · [All operations](https://skmtc.dev/postpen/apis/postpen-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postpen/apis/postpen-agent-api/revisions/2b07a2e1bfe7?raw)