Team folders

Create a Team folder

Creates a folder in a Team workspace where the token has write access. A top-level folder needs workspace_id — a Team token can span several workspaces, so MDflow never guesses one and answers 400 without it. A subfolder inherits its parent's workspace; a conflicting workspace_id is a 400. Duplicate sibling names are automatically disambiguated.

post/api/team/v1/folders

Request

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

Request body

namestring required
descriptionstring nullable

Empty text is stored as null.

parent_idstring uuid nullable

Parent folder for a subfolder; its workspace is used.

workspace_idstring uuid

Team workspace for a top-level folder. Required when parent_id is not set (MDflow never guesses a workspace); must match the parent's workspace when it is.

Response

Created 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.