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);
Risposta200
{
  "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.

Parametri

folder_idstring

ID of the asset folder.

Payload della richiesta

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.

Payload di risposta

created_at
string
obbligatorio
updated_at
string
obbligatorio
id
string
obbligatorio
name
string
obbligatorio

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

parent_id
nullable string
obbligatorio

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

path
string
obbligatorio

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.

Continua con la documentazione, le guide e gli esempi per questo argomento.