Get Shareable Link Folders
Retrieves the list of folders associated with a shareable link with pagination and sorting
/api/v1/{app_id}/shareable-links/{token}/folders- API
- DAM
- OpenAPI
- dam-api
- Updated
- Apr 26, 2026
dam-api:GET:/api/v1/{app_id}/shareable-links/{token}/folders
Retrieves the list of folders associated with a shareable link with pagination and sorting
API ownership
- API family: DAM public reads
- Best for: Public asset-library folder, media, facet, and shareable-link reads. Use Management API DAM routes for authenticated administration.
- Guide route: /media/dam/latest
The OpenAPI contract defines the method, path, parameters, request body, and responses for this operation.
Operation
- Method:
GET - Path:
/api/v1/\{app_id\}/shareable-links/\{token\}/folders - Summary: Get Shareable Link Folders
- Description: Retrieves the list of folders associated with a shareable link with pagination and sorting
- OpenAPI contract: dam-api
- Operation ID: Not documented in the OpenAPI contract.
Operation key uses API family, method, and path because this OpenAPI contract does not publish an operation ID.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| token | path | Yes | string | Shareable Link Token |
| page | query | No | integer | Page number (default: 1) |
| per_page | query | No | integer | Items per page (default: 20, max: 100) |
| sort_by | query | No | string | Sort field: name, created_at, updated_at (default: created_at) |
| sort_order | query | No | string | Sort order: asc, desc (default: desc) |
Request body
Not documented in the OpenAPI contract.
Responses
| Status | Description | Content |
|---|---|---|
| 200 | Shareable link folders retrieved successfully | application/json (object) |
| 400 | Invalid request | application/json (object) |
| 404 | Shareable link not found | application/json (object) |
| 500 | Internal server error | application/json (object) |
200 - object
Shareable Link Folders Response
| Property | Type | Required | Details |
|---|---|---|---|
data | object[] | No | - |
pagination | object | No | - |
success | boolean | No | - |
Folder
| Property | Type | Required | Details |
|---|---|---|---|
created_at | string | No | - |
file_count | integer | No | - |
has_content_access | boolean | No | - |
id | string | No | - |
image_count | integer | No | - |
is_default | boolean | No | - |
name | string | No | - |
parent_id | string | No | - |
public | boolean | No | - |
slug | string | No | - |
updated_at | string | No | - |
video_count | integer | No | - |
Page Info
| Property | Type | Required | Details |
|---|---|---|---|
page | integer | No | - |
per_page | integer | No | - |
total_items | integer | No | - |
total_pages | integer | No | - |
Generated example (synthetic):
{
"data": [
{
"created_at": "string",
"file_count": 0,
"has_content_access": false,
"id": "string",
"image_count": 0,
"is_default": false,
"name": "string",
"parent_id": "string",
"public": false,
"slug": "string",
"updated_at": "string",
"video_count": 0
}
],
"pagination": {
"page": 0,
"per_page": 0,
"total_items": 0,
"total_pages": 0
},
"success": false
}400 - object
Error
| Property | Type | Required | Details |
|---|---|---|---|
details | string[] | No | - |
error | string | No | - |
Generated example (synthetic):
{
"details": [
"string"
],
"error": "string"
}404 - object
Error
| Property | Type | Required | Details |
|---|---|---|---|
details | string[] | No | - |
error | string | No | - |
Generated example (synthetic):
{
"details": [
"string"
],
"error": "string"
}500 - object
Error
| Property | Type | Required | Details |
|---|---|---|---|
details | string[] | No | - |
error | string | No | - |
Generated example (synthetic):
{
"details": [
"string"
],
"error": "string"
}Contract identity
Use these fields to confirm you are implementing the intended endpoint contract.
- API family: DAM public reads
- Method:
GET - Path:
/api/v1/\{app_id\}/shareable-links/\{token\}/folders - Operation ID: Not documented in the OpenAPI contract.
- OpenAPI tag: Shareable Links
- OpenAPI summary: Get Shareable Link Folders