List folders

Your folders with their IDs, in the order you set.

GET https://cotlet.dev/api/v1/instapaper/folders

read

Returns every folder in the account with its ID, title and position. The ID is what list_bookmarks, save_bookmark and move_bookmark take. Home, Archive and Liked are not folders and are not listed.

Parameters

No parameters.

Request

cURL
curl https://cotlet.dev/api/v1/instapaper/folders \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("instapaper", "list_folders")
Node.js
const result = await cotlet.call('instapaper', 'list_folders');
CLI
cotlet call instapaper list_folders

Example response

JSON

{
  "folders": [
    {
      "folder_id": 381204,
      "title": "Recipes",
      "position": 1
    },
    {
      "folder_id": 381877,
      "title": "Conference talks",
      "position": 2
    },
    {
      "folder_id": 402115,
      "title": "Reading",
      "position": 3
    }
  ]
}

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.