Sign inGet Started

Rename or move a media-library folder

PATCH
/v1/asset-folders/{folder_id}
const folder = await bird.assets.folders.update(
  "asf_01krdgeqcxet5s7t44vh8rt9mg",
  { name: "Autumn campaign" },
);
console.log(folder.path);
Respuesta200
{
  "created_at": "2026-05-20T09:14:52Z",
  "updated_at": "2026-05-25T16:42:01Z",
  "id": "asf_01krdgeqcxet5s7t44vh8rt9mg",
  "parent_id": "asf_01krdgeqcxet5s7t44vh8rt9mg"
}

Renames a folder, moves it, or both. Send parent_id to move the folder into another folder, or null to move it to the top level.

Moving a folder carries its subfolders and assets with it and changes no URLs, so messages that embed those assets are unaffected. A folder cannot be moved into itself or into one of its own subfolders, and the resulting tree cannot exceed 10 levels.

Parámetros

folder_idstring

ID of the asset folder.

Cuerpo de la solicitud

name
string

The folder's display name. Must be unique among folders sharing the same parent, compared without regard to case. Cannot contain /.

parent_id
nullable string

The folder to move this one into. Send null to move it to the top level of the library. A folder cannot be moved into itself or into one of its own subfolders.

Carga de respuesta

created_at
string
obligatorio
updated_at
string
obligatorio
id
string
obligatorio
name
string
obligatorio

The folder's display name. Unique among folders sharing the same parent, compared without regard to case.

parent_id
nullable string
obligatorio

The folder this one sits in, or null when it sits at the top level of the library.

path
string
obligatorio

The folder's location written out from the top level, such as /Marketing/Logos. Provided so a caller can display a folder without walking its parents.