List posts awaiting approval
list_pending_approvalsList social media posts awaiting team review, filter by status, author, or profile, and count pending approvals. Retrieve a single approval with preview links and publication details.
Instructions
Posts created by team members (Editors and Contributors) that wait for the account owner or an Admin: status pending_approval (an Editor's post, published once approved) or draft (a Contributor's, the reviewer sets the date). By default only open ones, newest first. Each item has approval_id, status, version (needed to approve), profile_username, platforms, post_type, title, caption, platform_content, scheduled_date, expires_at, author_email, author_role, and after a decision decided_by, decision_comment and job_id; closed ones are approved, rejected, withdrawn or expired. With approval_id it returns that one item with its upload fields, preview_url and thumbnail_url (temporary links) and destinations_effective. Editors and Contributors see only their own posts. Page with before = the previous next_before. With count_only: true it lists nothing and answers only counts {status: n} and total for the same filters (status, profile_username, author), e.g. how many posts wait for review. Not generally available yet: until post approvals are switched on for the account, these calls answer 503 post_approvals_disabled (the feature is off, not a temporary failure).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_pending_approvals"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Items per page, 1-200. Default 50. | |
| author | No | Only posts by this team member email. | |
| before | No | `next_before` of the previous page. | |
| status | No | Statuses to list. Default: the open ones (pending_approval, draft). | |
| count_only | No | Only the number of posts per status (`counts`, `total`), no items; limit and before are ignored. | |
| approval_id | No | `approval_id` from list_pending_approvals (also returned by an upload that went to approval). | |
| profile_username | No | Only this Upload-Post profile. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No |