Category Queue

Documentation for Social Media Posting API

📄️ Get all categories with their queue status

Returns categories with status: 'available' (no queue), 'in_queue' (active/paused queue), or 'draft' (queue in draft).

📄️ Create a new category queue

Creates a queue in draft status for a category. Published posts are auto-added. Use update endpoint to activate.

📄️ Fetch category queues for a location

Retrieves a paginated list of all category queues for a given location, excluding any that have been marked as deleted.

📄️ Fetch a category queue by ID

Retrieves the details of a single category queue by its unique ID. The response includes a count of posts within the queue that have errors.

📄️ Update queue settings or status

Updates queue status (active/paused/deleted), time slots, or skip dates.

📄️ Fetch items from a queue

Returns paginated queue items. Pass sessionId to get draft items from an edit session instead of live items.

📄️ Start or resume an edit session

Creates a draft copy of queue items for editing. Changes are staged until saved or discarded.

📄️ Save edit session changes

Applies all staged changes to the live queue and closes the edit session.

📄️ Discard edit session changes

Cancels the edit session and deletes all staged changes without affecting the live queue.

📄️ Fetch calendar view for an edit session

Retrieves a calendar preview of scheduled posts based on draft items within an edit session. This shows how posts would be scheduled if changes were saved.

📄️ Fetch slot information for queue items

Returns paginated slot information (scheduledDateTime, isSkipped) for queue items. Pass sessionId to get slots for draft items, or omit for live items. Call this after mutations to refresh slot data.

📄️ Delete an item from a queue

Deletes an item from a specific category queue.

📄️ Update an item in a queue

Updates the content or variations of a specific item within a category queue.

📄️ Get scheduled posts calendar view

Returns scheduled posts from active queues within a date range. Supports filtering by categories and accounts.

📄️ Delete an active post and schedule the next one

Deletes a post that is currently scheduled and automatically triggers the scheduling of the next available post in the queue.

📄️ Reset an item in a queue

Resets a specific queue item to its original state, discarding any modifications made.

📄️ Clone a queue item

Duplicates an existing queue item at a specified order position. Requires an active edit session.

📄️ Create a new item in the queue

Adds a new post item to a queue. Use sessionId for edit session or directToQueue for immediate addition.