timeline_list_scheduled_events
Retrieve scheduled social media events with filters for platform, status, date range, and campaign track to monitor content automation workflows.
Instructions
List scheduled events with optional filtering by track, status, platform, and date range.
STATUS FILTERING:
'all': Returns all events regardless of status
'pending': Returns events that haven't been generated yet (contentGenerated = false)
'generated': Returns events that have been generated but not posted yet (contentGenerated = true, posted = false)
'posted': Returns events that have been posted (posted = true)
DATE FILTERING:
startDate/endDate use DATE ONLY comparison (time is ignored)
Format: YYYY-MM-DD or ISO 8601 datetime string
Example: startDate="2025-10-14" matches ALL events scheduled on Oct 14, regardless of time
To get events for a single day, use the same date for both startDate and endDate
EXAMPLES:
Get all posted events from today: { "startDate": "2025-10-14", "endDate": "2025-10-14", "status": "posted" }
Get all Reddit events this week: { "platform": "reddit", "startDate": "2025-10-14", "endDate": "2025-10-20" }
Get pending events in a specific track: { "trackId": "track-uuid", "status": "pending" }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| endDate | No | End date for filtering (YYYY-MM-DD). Date-only comparison - time is ignored. | |
| limit | No | Maximum number of events to return | |
| offset | No | Offset for pagination | |
| platform | No | Filter by platform (x, reddit, linkedin, instagram, tiktok, youtube) | |
| startDate | No | Start date for filtering (YYYY-MM-DD). Date-only comparison - time is ignored. | |
| status | No | Filter by event status | all |
| trackId | No | Filter by track ID |