Folders

Rename or move a folder.

Use this endpoint to change a folder's slug, name, or parent_id. The id in the request body must match the path parameter or the call returns 400. Name and path-uniqueness rules from create apply: invalid names return 400, a path collision returns 409, and a missing parent_id returns 404.

put/folders/{folder_id}

Request

  • Base URL
    /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /api/folders/{folder_id}
  • Auth
    API key in header Authorization

Path parameters

folder_idstring uuid required

Request body

Response

Successful Response

countinteger

Number of folders returned (0 or 1).

Changes

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status