v3

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-012582298.4 KB
Queue

Get queue

Retrieve queue slots and scheduled drafts between start_date and end_date (inclusive).

Required permission: READ access to this social set.

Notes:

  • start_date and end_date are interpreted in the social set timezone.
  • Ranges larger than 62 days are rejected.
get/v2/social-sets/{social_set_id}/queue

Path parameters

social_set_idinteger required

Query parameters

start_datestring required
end_datestring required

Response

Queue view (slots + scheduled drafts) for a date range.

social_set_idinteger required

ID of the social set (account) this queue belongs to.

start_datestring required

YYYY-MM-DD in the social set timezone

end_datestring required

YYYY-MM-DD in the social set timezone

Example response

{
  "social_set_id": 123,
  "start_date": "2026-02-01",
  "end_date": "2026-02-29",
  "days": [
    {
      "items": [
        {
          "at": "2026-02-12T22:00:00Z",
          "kind": "queue_slot",
          "draft": {
            "id": 12345,
            "preview": "Hello world",
            "scheduled_date": "2025-01-20T14:00:00Z",
            "draft_title": "My launch thread",
            "mastodon_post_enabled": true,
            "social_set_id": 67890,
            "share_url": "https://typefully.com/share/abc123",
            "private_url": "https://typefully.com/?d=12345&a=67890",
            "tags": [
              "marketing",
              "product"
            ],
            "created_at": "2025-01-15T10:30:00Z",
            "updated_at": "2025-01-16T09:15:00Z",
            "published_at": "2025-01-20T14:00:05Z",
            "mastodon_post_published_at": "2025-01-20T14:00:05Z",
            "linkedin_post_published_at": "2025-01-20T14:00:05Z",
            "threads_post_published_at": "2025-01-20T14:00:05Z",
            "bluesky_post_published_at": "2025-01-20T14:00:05Z",
            "substack_post_published_at": "2025-01-20T14:00:05Z",
            "x_post_published_at": "2025-01-20T14:00:05Z",
            "x_published_url": "https://x.com/username/status/1234567890",
            "linkedin_published_url": "https://www.linkedin.com/feed/update/urn:li:share:1234567890",
            "mastodon_published_url": "https://mastodon.social/@username/1234567890",
            "threads_published_url": "https://www.threads.net/@username/post/ABC123",
            "bluesky_published_url": "https://bsky.app/profile/username.bsky.social/post/abc123",
            "substack_published_url": "https://substack.com/@username/note/c-123456789"
          }
        }
      ]
    }
  ]
}