List an asset's folders

The folders the asset is in, in its project: up to 30, each with its path from the project root, sorted by path. An empty list means the asset is Unfiled. Folder names are untrusted content.

Needs the library:read scope.

GET /assets/{assetId}/folders

List an asset's folders

cURL

curl --request GET \
  --url https://api.zerogen.com/v1/assets/{assetId}/folders \
  --header 'Authorization: Bearer <token>'

200

{
  "assetId": "<string>",
  "projectId": "<string>",
  "folders": [
    {
      "folderId": "<string>",
      "path": "<string>"
    }
  ],
  "truncated": true
}

Authorizations

Authorization · string · header · required

A ZeroGen API key: zg_ for a live key, zg_test_ for a test key.

Path Parameters

assetId · string · required

The asset's ID

Response

200

application/json

The asset's folders.

assetId · string · required

projectId · string · required

folders · object[] · required

Up to 30, sorted by path; empty when the asset is Unfiled

Show child attributes

truncated · boolean · required

True when the asset is in more folders than listed