Folders

Create a Team Space folder

Owners/admins always; members while the workspace setting members_can_create_folders is on (the default), otherwise 403 ADMIN_REQUIRED.

post/v1/workspaces/{workspaceId}/folders

Request

namestring required

slugstring

Auto-generated from name if omitted.

descriptionstring

parent_idstring

readmestring

Markdown folder guide.

visibility'inherit' | 'public' | 'workspace' | 'private'

A label for the folder, not enforced on its contents: each artifact and file keeps its own visibility.

Created

idstring

namestring

slugstring

descriptionstring nullable

artifact_countinteger

parent_idstring nullable

Team Space folders only.

visibility'inherit' | 'public' | 'workspace' | 'private'

Team Space folders only.

subfolder_countinteger

Team Space folders only.

pathstring

Slug path; single-folder Team Space responses only.

readmestring nullable

Single-folder Team Space responses only.

effective_visibilitystring

Single-folder Team Space responses only.

created_atstring date-time