List

To list the existing folders you need to execute a GET request against the /libraries/:id/folders endpoint.

Since potentially there could be thousands of folders, pagination is supported with limit, order and after arguments. Read about pagination to learn the details of it. By default maximum 100 folders will be returned in the response.

Request (listing all folders)

curl --request GET \
  --url https://api.digitalsamba.com/api/v1/libraries/45d125d8-bac9-43a5-a6a8-311a5433239d/folders \
  --user YOUR_TEAM_ID:YOUR_DEVELOPER_KEY

Response (200 OK)

{
    "total_count": 6124,
    "data": [
        {
            "id": "1fc95d41-5358-4a81-adb4-5cd8c12e8308",
            "name": "Birthday Party",
            "parent_id": null,
            "source": "api",
            "created_at": "2024-10-08T08:05:51Z"
        },
        ...............99 more folders...............
    ]
} 

Request (get a concrete folder)

curl --request GET \
  --url https://api.digitalsamba.com/api/v1/libraries/45d125d8-bac9-43a5-a6a8-311a5433239d/folders/1fc95d41-5358-4a81-adb4-5cd8c12e8308 \
  --user YOUR_TEAM_ID:YOUR_DEVELOPER_KEY

Response (200 OK)

{
    "id": "1fc95d41-5358-4a81-adb4-5cd8c12e8308",
    "name": "Birthday Party",
    "parent_id": null,
    "source": "api",
    "created_at": "2024-10-08T08:05:51Z"
}

Last updated