latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-189455174.2 KB

addaba6fddad

Folder

Update folder

Update the folder by its ID. JSON null parent_id moves it to the library root.

patch/v1/folders/{id}

Request body

namestring

Name of the folder.

parent_idstring nullable

Parent folder ID. JSON null moves the folder to the library root.

Example request

{
  "name": "Guides",
  "parent_id": "9bsv0s46s6s002p9ltq0"
}

Response

OK

idstring required

Unique identifier of the folder.

namestring required

Name of the folder.

created_atstring date-time required

Date when the folder was created.

updated_atstring date-time nullable required

Date when the folder was updated.

Example response

{
  "id": "9bsv0s46s6s002p9ltq0",
  "name": "Guides",
  "library": {
    "id": "9bsv0s46s6s002p9ltq0",
    "name": "Product"
  },
  "parent": {
    "id": "9bsv0s46s6s002p9ltq0",
    "name": "Guides",
    "parent_id": "9bsv0s46s6s002p9ltq0"
  },
  "created_by": {
    "id": "9bsv0s46s6s002p9ltq0",
    "first_name": "Test",
    "last_name": "User",
    "picture": "https://example.com/users/my-user.png"
  }
}