Team folders

Update a Team folder

Renames, re-describes, or moves a Team folder. Provide at least one of name, description, or parent_id. Renaming or moving disambiguates the name against the destination siblings. parent_id null moves the folder to the workspace top level; a parent in another workspace returns 404, and making a folder its own parent or a descendant's child is rejected with 400. Folders never move across workspaces. Requires write access to the folder's workspace.

patch/api/team/v1/folders/{id}

Request

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

Path parameters

idstring uuid required

Folder UUID.

Request body

namestring
descriptionstring nullable

Empty text or null clears the description; an absent key leaves it untouched.

parent_idstring uuid nullable

Destination parent in the same workspace, or null for the workspace top level.

Response

Updated Team folder.

idstring uuid required
workspace_idstring uuid required

The Team workspace this folder belongs to. Never changes.

parent_idstring uuid nullable required

Parent folder, or null for a top-level folder.

namestring required
descriptionstring nullable required

The primary retrieval signal for the documents inside.

created_atstring date-time required
updated_atstring date-time required

Changes

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