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

Payload de resposta

created_at
string
obrigatório
updated_at
string
obrigatório
id
string
obrigatório
name
string
obrigatório

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

parent_id
nullable string
obrigatório

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

path
string
obrigatório

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.