files

Create a folder

Clerk session or agt_ token with files:write (live tier re-checked). A root folder may be created by any ic-member+; creating a SUB-folder additionally requires that the caller manage the named parent.

post/api/folders

Request

  • Base URL: https://www.immersivecommons.com
  • URL: https://www.immersivecommons.com/api/folders
  • Auth: HTTP bearer

Request body

namestring required
descriptionstring
parentstring

Parent folder id. Omit for a root folder; supplying one requires that the caller manage it.

visibility'private' | 'ic-members' | 'grantees'
granteesstring[]
tagsstring[]

Response

The new folder.

okboolean required
via'clerk' | 'agent'

Changes

No recorded changes to this operation across all 1 revision of this API.