Sign inGet Started

Get a media-library folder by ID

GET
/v1/asset-folders/{folder_id}
const folder = await bird.assets.folders.get(
  "asf_01krdgeqcxet5s7t44vh8rt9mg",
);
console.log(folder.path);
Réponse200
{
  "created_at": "2026-05-20T09:14:52Z",
  "updated_at": "2026-05-25T16:42:01Z",
  "id": "asf_01krdgeqcxet5s7t44vh8rt9mg",
  "parent_id": "asf_01krdgeqcxet5s7t44vh8rt9mg"
}

Returns one folder from the workspace's media library, including its resolved path. A deleted folder is not returned.

Paramètres

folder_idstring

ID of the asset folder.

Contenu de la réponse

created_at
string
obligatoire
updated_at
string
obligatoire
id
string
obligatoire
name
string
obligatoire

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

parent_id
nullable string
obligatoire

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

path
string
obligatoire

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.

Poursuivez avec la documentation, les guides et les exemples sur ce sujet.