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

Parámetros

folder_idstring

ID of the asset folder.

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.