Actions12
- Draft Actions
- Media Actions
- Social Set Actions
- Tag Actions
- User Actions
Draft → List Drafts
AI-generatedSummary
Retrieves a list of draft posts for a specific social set, optionally filtering by status, tags, or sorting criteria.
Inputs
- socialSetId (required) — The ID of the social set.
- returnAll — Whether to return all results or only up to a given limit.
- limit — Max number of results to return (1-50). Only available when 'Return All' is false.
- filters — A collection of filters to narrow results: Status (draft, error, published, publishing, scheduled), Tags (comma-separated slugs), or Order By (created_at, published_at, scheduled_date, updated_at).
Output shape
A list of draft records.
Uses offset-based pagination with a default page size of 50 items. When 'Return All' is true, it automatically paginates to fetch all results.
Examples
Example 1: Fetch up to 10 drafts from a specific social set
Set 'Return All' to false, 'Limit' to 10.
Example 2: Retrieve all scheduled drafts for a social set
Set 'Return All' to true, 'Filters > Status' to 'Scheduled'.
Example 3: Get the most recent drafts, ordered by creation date descending
Set 'Return All' to true, 'Filters > Order By' to 'Created At (Descending)'.