Folders

Create a folder

Creates a folder owned by the authenticated user. Duplicate sibling names are automatically disambiguated.

post/api/v1/folders

Request

  • Base URL: https://mdflow.cz
  • URL: https://mdflow.cz/api/v1/folders
  • Auth: HTTP bearer

Request body

namestring required
descriptionstring
parent_idstring uuid nullable
workspace_idstring uuid

Workspace for a top-level folder. Ignored when parent_id is set (the parent's workspace wins). Defaults to the owner's oldest workspace.

Response

Created folder.

idstring uuid required
namestring required
descriptionstring nullable required
parent_idstring uuid nullable required
workspace_idstring uuid required

The workspace this folder belongs to.

path_stringstring

Path segment names joined by " / ". Returned by the list and get endpoints; omitted from create and update responses.

created_atstring date-time required
updated_atstring date-time required

Changes

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