File sources into a folder, or out of every folder
Up to 500 of the caller's own sources per call, all or nothing: if the folder is not the caller's, or any id is not one of the caller's sources, nothing moves and the answer is 404 — with the unknown ids in `details.missing` for the latter. `moved` lists the sources whose folder changed; `unchanged` counts the ones already there.
/api/v1/sources/move“Try it” is off for this endpoint: it deletes or rewrites data in bulk. Use the code samples instead.
Up to 500 of the caller's own sources per call, all or nothing: if the folder is not the caller's, or any id is not one of the caller's sources, nothing moves and the answer is 404 — with the unknown ids in details.missing for the latter. moved lists the sources whose folder changed; unchanged counts the ones already there.
AuthorizationBearer <token>A personal access token (rsk_…) or a Supabase access token.
application/json- body
source_ids*array<>1 <= items <= 500folder_id*|nullMoved
application/json- response
moved*array<>unchanged*numbercurl -X POST 'https://www.ressource.social/api/v1/sources/move' \ -H 'Content-Type: application/json' \ -d '{ "source_ids": [ "0ef3b708-5992-473f-8907-de8eaa4f1ec9" ], "folder_id": "7695bac3-9397-4ec2-9335-45a2a16f1901"}'{ "moved": [ "e0843386-b61f-4bac-9e6c-7f4d8b178913" ], "unchanged": 0}The caller's folder tree GET
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.
Rename, describe, recolour or move a folder PATCH
Only the fields sent change. `parent_folder_id` moves the folder with its whole subtree — `null` to the root. Moving a folder into itself or one of its own subfolders, or past ten levels deep, is 400; a parent that is not the caller's is 404; a name a new sibling already has is 409.