Get Shareable Link Folders

Retrieves the list of folders associated with a shareable link with pagination and sorting

GET/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.

Parameters5 parameters
NameInRequiredTypeDescription
tokenpathYesstringShareable Link Token
pagequeryNointegerPage number (default: 1)
per_pagequeryNointegerItems per page (default: 20, max: 100)
sort_byqueryNostringSort field: name, created_at, updated_at (default: created_at)
sort_orderqueryNostringSort order: asc, desc (default: desc)
Request bodyNo documented body

Not documented in the OpenAPI contract.

Responses4 statuses
StatusDescriptionContent
200Shareable link folders retrieved successfullyapplication/json (object)
400Invalid requestapplication/json (object)
404Shareable link not foundapplication/json (object)
500Internal server errorapplication/json (object)

200 - object

PropertyTypeRequiredDetails
dataobject[]No-
paginationobjectNo-
successbooleanNo-
Folder
PropertyTypeRequiredDetails
created_atstringNo-
file_countintegerNo-
has_content_accessbooleanNo-
idstringNo-
image_countintegerNo-
is_defaultbooleanNo-
namestringNo-
parent_idstringNo-
publicbooleanNo-
slugstringNo-
updated_atstringNo-
video_countintegerNo-
Page Info
PropertyTypeRequiredDetails
pageintegerNo-
per_pageintegerNo-
total_itemsintegerNo-
total_pagesintegerNo-

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

PropertyTypeRequiredDetails
detailsstring[]No-
errorstringNo-

Generated example (synthetic):

{
  "details": [
    "string"
  ],
  "error": "string"
}

404 - object

Error

PropertyTypeRequiredDetails
detailsstring[]No-
errorstringNo-

Generated example (synthetic):

{
  "details": [
    "string"
  ],
  "error": "string"
}

500 - object

Error

PropertyTypeRequiredDetails
detailsstring[]No-
errorstringNo-

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

Get Shareable Link Folders

# Get Shareable Link Folders Retrieves the list of folders associated with a shareable link with pagination and sorting
GET /api/v1/{app_id}/shareable-links/{token}/folders
Purpose

Retrieves the list of folders associated with a shareable link with pagination and sorting

Required inputs

token path

Primary response

200 ยท Shareable link folders retrieved successfully

Operation key

dam-api:GET:/api/v1/{app_id}/shareable-links/{token}/folders

## 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](/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. - Stable operation key: `dam-api:GET:/api/v1/{app_id}/shareable-links/{token}/folders` 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):** ```json { "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):** ```json { "details": [ "string" ], "error": "string" } ``` ### 404 - object #### Error | Property | Type | Required | Details | | --- | --- | --- | --- | | `details` | string[] | No | - | | `error` | string | No | - | **Generated example (synthetic):** ```json { "details": [ "string" ], "error": "string" } ``` ### 500 - object #### Error | Property | Type | Required | Details | | --- | --- | --- | --- | | `details` | string[] | No | - | | `error` | string | No | - | **Generated example (synthetic):** ```json { "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. - Stable operation key: `dam-api:GET:/api/v1/{app_id}/shareable-links/{token}/folders` - OpenAPI tag: Shareable Links - OpenAPI summary: Get Shareable Link Folders