Sign in
workspace

Update workspace folder

Rename a folder, change its icon, and/or move it.

Sending parent_id: null moves the folder to the workspace root; leaving the field out keeps it where it is. Move and rename are applied together or not at all, and the new name is checked for a clash against the destination.

patch/api/workspace/folders/{folder_id}

Path parameters

folder_idstring required

Request body

namestring nullable
iconstring nullable
parent_idstring nullable

Response

Successful Response

idstring required
workspace_idstring required
namestring required
iconstring nullable
parent_idstring nullable
created_atstring date-time required
updated_atstring date-time required
file_countinteger

Changes

Changed in 3 of the 165 revisions of this API.14

  • 7c34110a30723See the full diff
    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

  • 8b99899127181See the full diff
    • ○

      endpoint added

      endpoint-added

  • 8c84efcb3afb1See the full diff
    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 96 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog