Utilities

Queue

Get queue schedule for a profile

GET
/v1/queue/slots
AuthorizationBearer <token>

API key authentication - use your Late API key as a Bearer token

In: header

Query Parameters

profileIdstring

Response Body

application/json

application/json

curl -X GET "https://getlate.dev/api/v1/queue/slots?profileId=string"
{
  "exists": true,
  "schedule": {
    "profileId": "64f0a1b2c3d4e5f6a7b8c9d0",
    "timezone": "America/New_York",
    "slots": [
      {
        "dayOfWeek": 1,
        "time": "09:00"
      },
      {
        "dayOfWeek": 1,
        "time": "14:00"
      },
      {
        "dayOfWeek": 3,
        "time": "09:00"
      },
      {
        "dayOfWeek": 5,
        "time": "10:00"
      }
    ],
    "active": true,
    "createdAt": "2024-01-15T10:30:00Z",
    "updatedAt": "2024-11-01T14:00:00Z"
  },
  "nextSlots": [
    "2024-11-04T09:00:00-05:00",
    "2024-11-04T14:00:00-05:00",
    "2024-11-06T09:00:00-05:00"
  ]
}
Empty
{
  "error": "Unauthorized"
}
Empty

Delete queue schedule for a profile

DELETE
/v1/queue/slots
AuthorizationBearer <token>

API key authentication - use your Late API key as a Bearer token

In: header

Query Parameters

profileIdstring

Response Body

application/json

application/json

curl -X DELETE "https://getlate.dev/api/v1/queue/slots?profileId=string"
{
  "success": true,
  "deleted": true
}
Empty
{
  "error": "Unauthorized"
}

Create or update queue schedule for a profile

PUT
/v1/queue/slots
AuthorizationBearer <token>

API key authentication - use your Late API key as a Bearer token

In: header

profileIdstring
timezonestring
slots
active?boolean
Defaulttrue
reshuffleExisting?boolean

Whether to reschedule existing queued posts to match new slots

Defaultfalse

Response Body

application/json

application/json

curl -X PUT "https://getlate.dev/api/v1/queue/slots" \  -H "Content-Type: application/json" \  -d '{    "profileId": "64f0a1b2c3d4e5f6a7b8c9d0",    "timezone": "America/New_York",    "slots": [      {        "dayOfWeek": 1,        "time": "09:00"      },      {        "dayOfWeek": 1,        "time": "14:00"      },      {        "dayOfWeek": 3,        "time": "09:00"      },      {        "dayOfWeek": 5,        "time": "10:00"      }    ],    "active": true,    "reshuffleExisting": false  }'
{
  "success": true,
  "schedule": {
    "profileId": "64f0a1b2c3d4e5f6a7b8c9d0",
    "timezone": "America/New_York",
    "slots": [
      {
        "dayOfWeek": 1,
        "time": "09:00"
      },
      {
        "dayOfWeek": 1,
        "time": "14:00"
      },
      {
        "dayOfWeek": 3,
        "time": "09:00"
      },
      {
        "dayOfWeek": 5,
        "time": "10:00"
      }
    ],
    "active": true
  },
  "nextSlots": [
    "2024-11-04T09:00:00-05:00",
    "2024-11-04T14:00:00-05:00"
  ],
  "reshuffledCount": 0
}
Empty
{
  "error": "Unauthorized"
}
Empty

Preview upcoming queue slots for a profile

GET
/v1/queue/preview
AuthorizationBearer <token>

API key authentication - use your Late API key as a Bearer token

In: header

Query Parameters

profileIdstring
count?integer
Default20
Range1 <= value <= 100

Response Body

application/json

application/json

curl -X GET "https://getlate.dev/api/v1/queue/preview?profileId=string"
{
  "profileId": "64f0a1b2c3d4e5f6a7b8c9d0",
  "count": 10,
  "slots": [
    "2024-11-04T09:00:00-05:00",
    "2024-11-04T14:00:00-05:00",
    "2024-11-06T09:00:00-05:00",
    "2024-11-08T10:00:00-05:00",
    "2024-11-11T09:00:00-05:00",
    "2024-11-11T14:00:00-05:00",
    "2024-11-13T09:00:00-05:00",
    "2024-11-15T10:00:00-05:00",
    "2024-11-18T09:00:00-05:00",
    "2024-11-18T14:00:00-05:00"
  ]
}
Empty
{
  "error": "Unauthorized"
}
Empty

Get the next available queue slot for a profile

Returns the next available posting slot, taking into account already scheduled posts to avoid conflicts. Useful for scheduling posts via queue without manual time selection.

GET
/v1/queue/next-slot
AuthorizationBearer <token>

API key authentication - use your Late API key as a Bearer token

In: header

Query Parameters

profileIdstring

Response Body

application/json

curl -X GET "https://getlate.dev/api/v1/queue/next-slot?profileId=string"
{
  "profileId": "64f0a1b2c3d4e5f6a7b8c9d0",
  "nextSlot": "2024-11-04T09:00:00-05:00",
  "timezone": "America/New_York"
}