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

Parameters

folder_idstring

ID of the asset folder.

Response Payload

created_at
string
required
updated_at
string
required
id
string
required
name
string
required

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

parent_id
nullable string
required

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

path
string
required

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.

Continue with the documentation, guides and examples for this topic.