Calendar & Utilities

Calendar view and scheduling helpers

Calendar views, scheduling summary, and helper endpoints to find optimal posting times.

Get Calendar View

See scheduled posts and available slots in a calendar format:

GET /v1/workspaces/{id}/schedule/calendar/?start_date=2025-01-01&end_date=2025-01-31

Response

{
  "calendar": [
    {
      "date": "2025-01-15",
      "scheduled_posts": [
        {
          "id": 123,
          "time": "09:00:00",
          "text": "Good morning!",
          "platforms": ["twitter", "linkedin"]
        }
      ],
      "available_slots": [
        { "time": "14:00:00", "channels": ["twitter", "facebook"] },
        { "time": "17:00:00", "channels": ["linkedin"] }
      ]
    }
  ]
}

Get Schedule Summary

Overview of scheduling status:

GET /v1/workspaces/{id}/schedule/summary/

Response

{
  "total_scheduled": 45,
  "queue_length": 12,
  "next_post_time": "2025-01-15T14:00:00Z",
  "available_slots_today": 3,
  "available_slots_this_week": 18
}

Find Next Available Slot

Get the next available posting window:

GET /v1/workspaces/{id}/schedule/next-slot/?platform=twitter

Response

{
  "next_slot": "2025-01-15T14:00:00Z",
  "platform": "twitter",
  "day_of_week": "Monday"
}

Get Optimal Posting Times

AI-recommended best times to post based on historical engagement:

GET /v1/workspaces/{id}/schedule/optimal-times/?platform=twitter&count=5

Response

{
  "optimal_times": [
    {
      "day_of_week": "Monday",
      "time": "09:00:00",
      "engagement_score": 0.92,
      "platform": "twitter"
    },
    {
      "day_of_week": "Wednesday",
      "time": "14:00:00",
      "engagement_score": 0.89,
      "platform": "twitter"
    }
  ]
}

Query Parameters

start_date / end_date: Filter calendar by date range (YYYY-MM-DD)
platform: Filter by specific platform (twitter, linkedin, etc.)
count: Number of optimal times to return (default: 5)

Tip: Use optimal times to configure your Post Windows for maximum engagement. The AI learns from your audience's behavior over time.

Blocked Periods Overview