List queue

Posts waiting in the queue, in publishing order, with their Queue settings.

GET https://cotlet.dev/api/v1/tumblr/queues

read

Lists queued posts in the order Tumblr will publish them, 20 per page. Posts scheduled for a set time show publish_on; the rest follow the blog Queue settings, which come back as queue_settings. Tumblr holds at most 1,000 queued posts and publishes at most 50 a day.

Parameters

Parameters: list_queue
NameTypeDescription
blog string required string Blog name, e.g. 'studio-notes' for studio-notes.tumblr.com. Names come from list_blogs.
limit integer integer 1 to 20. Default: 20.
cursor string string Next page cursor from the previous call.

Request

cURL
curl "https://cotlet.dev/api/v1/tumblr/queues?blog=studio-notes" \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("tumblr", "list_queue", {"blog":"studio-notes"})
Node.js
const result = await cotlet.call('tumblr', 'list_queue', {"blog":"studio-notes"});
CLI
cotlet call tumblr list_queue --data '{"blog":"studio-notes"}'

Example response

JSON

{
  "queue_settings": {
    "posts_per_day": 3,
    "window": "09:00-21:00"
  },
  "queued": 14,
  "posts": [
    {
      "post_id": "771204518830",
      "summary": "New print: harbor at dawn",
      "tags": [
        "studio notes",
        "print"
      ],
      "publish_on": null
    }
  ],
  "next_cursor": null
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.