Queues API

Endpoints for managing publishing queues and scheduled content.

Authentication

All endpoints require JWT authentication.

---

List Queues

GET /api/queues

List all queues for the company.

Response

[
  {
    "id": "queue_123",
    "name": "Main Queue",
    "platforms": ["twitter", "linkedin"],
    "timeZone": "America/New_York",
    "isActive": true,
    "slots": [
      { "dayOfWeek": 1, "time": "09:00" },
      { "dayOfWeek": 3, "time": "14:00" },
      { "dayOfWeek": 5, "time": "09:00" }
    ],
    "itemCount": 12
  }
]

---

Create Queue

POST /api/queues

Create a new publishing queue.

Request Body

{
  "name": "LinkedIn Only",
  "platforms": ["linkedin"],
  "timeZone": "America/New_York",
  "isActive": true,
  "slots": [
    { "dayOfWeek": 1, "time": "09:00" },
    { "dayOfWeek": 2, "time": "09:00" },
    { "dayOfWeek": 3, "time": "09:00" },
    { "dayOfWeek": 4, "time": "09:00" },
    { "dayOfWeek": 5, "time": "09:00" }
  ]
}

---

Update Queue

PUT /api/queues/:id

Update queue settings or slots.

---

Delete Queue

DELETE /api/queues/:id

Delete a queue. Items are unscheduled but not deleted.

---

Add Item to Queue

POST /api/queues/:id/items

Add content to queue for automatic scheduling.

Request Body

{
  "content": "Post content here...",
  "platform": "twitter",           // Optional override
  "mediaUrls": ["https://..."]
}

Response

Returns created item with scheduled time.

---

List Queue Items

GET /api/queues/:id/items

List all items in a queue.

---

Remove Item

DELETE /api/queues/:queueId/items/:itemId

Remove item from queue.

---

Slot Schema

Field	Type	Description
dayOfWeek	number?	0-6 (Sun-Sat), null for daily
time	string	HH:MM format