Folders

Get a folder

Returns one folder owned by the authenticated user, including its full path (workspace → … → folder) and its compounded description: the labeled cascade of descriptions from the workspace down through each ancestor folder to this folder. A folder owned by another user returns 404.

get/api/v1/folders/{id}

Request

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

Path parameters

idstring uuid required

Folder UUID.

Response

Folder details.

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 required

Path segment names joined by " / ".

compounded_descriptionstring required

Labeled cascade of descriptions from the workspace down through each ancestor folder to this folder. Empty string when nothing in the chain has a description.

created_atstring date-time required
updated_atstring date-time required

Changes

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