API referenceFolders
Create a folder, at the root or inside another
Names are unique among siblings (409). A parent that is not the caller's is 404. Folders nest at most ten levels deep (400).
POST
Sends a real request with your token. Prefer a read-only token; it is kept in this browser's storage.
Names are unique among siblings (409). A parent that is not the caller's is 404. Folders nest at most ten levels deep (400).
header
AuthorizationBearer <token>A personal access token (rsk_…) or a Supabase access token.
application/json- body
name*stringLength
1 <= length <= 255parent_folder_id?|nulldescription?|nullcolor?|nullicon?|nullis_private?booleansort_order?integerRange
0 <= value <= 1000000The created folder
application/json- response
id*stringMatch
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Format
uuidname*stringdescription*string|nullparent_folder_id*|nullcolor*string|nullicon*string|nullis_private*boolean|nullsort_order*number|nulllevel*number|nullpath*string|nullcreated_at*string|nullupdated_at*string|nullchild_folder_count*numberbookmark_count*numbercurl -X POST 'https://www.ressource.social/api/v1/folders' \ -H 'Content-Type: application/json' \ -d '{ "name": "string"}'{ "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}