List drafts
Drafts on a blog, newest first.
GET https://cotlet.dev/api/v1/tumblr/drafts
read
Lists drafts of one blog, newest first, 20 per page. A queued post that fails to publish ends up here. Use post_id with edit_post to move a draft into the queue.
Parameters
| Name | Type | Description |
|---|---|---|
| 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 "https://cotlet.dev/api/v1/tumblr/drafts?blog=studio-notes" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("tumblr", "list_drafts", {"blog":"studio-notes"})const result = await cotlet.call('tumblr', 'list_drafts', {"blog":"studio-notes"});cotlet call tumblr list_drafts --data '{"blog":"studio-notes"}'Example response
{
"drafts": [
{
"post_id": "771198400021",
"summary": "(no text)",
"tags": [],
"saved_at": "2026-10-12T20:11:00Z"
}
],
"next_cursor": null
}