ressource.socialbetadocumentation
API referenceFolders

The caller's folder tree

Every folder, flat, with `parent_folder_id` and `level` to rebuild the tree, ordered as the Library sidebar orders them. Not paginated: the tree is bounded by the folder limit. `bookmark_count` counts sources filed directly in a folder, not in its subfolders.

GET
/api/v1/folders

Sends a real request with your token. Prefer a read-only token; it is kept in this browser's storage.

Every folder, flat, with parent_folder_id and level to rebuild the tree, ordered as the Library sidebar orders them. Not paginated: the tree is bounded by the folder limit. bookmark_count counts sources filed directly in a folder, not in its subfolders.

Authorization

headerAuthorizationBearer <token>

A personal access token (rsk_…) or a Supabase access token.

Response Body

Folders

application/json
  1. response
items*array<>
curl -X GET 'https://www.ressource.social/api/v1/folders'
{  "items": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string",      "description": "string",      "parent_folder_id": "26caaf35-00f1-4c8f-a2ac-cb04b9b9a6ec",      "color": "string",      "icon": "string",      "is_private": true,      "sort_order": 0,      "level": 0,      "path": "string",      "created_at": "string",      "updated_at": "string",      "child_folder_count": 0,      "bookmark_count": 0    }  ]}