Get Public Folders

Retrieves a flat list of public folders with pagination

GET/api/v1/{app_id}/folders/public
API
DAM
OpenAPI
dam-api
Updated
Apr 26, 2026

dam-api:GET:/api/v1/{app_id}/folders/public

Retrieves a flat list of public folders with pagination

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\}/folders/public
  • Summary: Get Public Folders
  • Description: Retrieves a flat list of public folders with pagination
  • 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.

Parameters3 parameters
NameInRequiredTypeDescription
app_idpathYesstringApp ID
pagequeryNointegerPage number (default: 1)
per_pagequeryNointegerItems per page (default: 20, max: 100)
Request bodyNo documented body

Not documented in the OpenAPI contract.

Responses3 statuses
StatusDescriptionContent
200Public folders retrieved successfullyapplication/json (object)
400Invalid requestapplication/json (object)
500Internal server errorapplication/json (object)

200 - object

Public Folders Response

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"
}

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\}/folders/public
  • Operation ID: Not documented in the OpenAPI contract.
  • OpenAPI tag: Folders
  • OpenAPI summary: Get Public Folders

Get Public Folders

# Get Public Folders Retrieves a flat list of public folders with pagination
GET /api/v1/{app_id}/folders/public
Purpose

Retrieves a flat list of public folders with pagination

Required inputs

app_id path

Primary response

200 ยท Public folders retrieved successfully

Operation key

dam-api:GET:/api/v1/{app_id}/folders/public

## 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}/folders/public` - Summary: Get Public Folders - Description: Retrieves a flat list of public folders with pagination - OpenAPI contract: dam-api - Operation ID: Not documented in the OpenAPI contract. - Stable operation key: `dam-api:GET:/api/v1/{app_id}/folders/public` Operation key uses API family, method, and path because this OpenAPI contract does not publish an operation ID. ## Parameters | Name | In | Required | Type | Description | | --- | --- | --- | --- | --- | | app_id | path | Yes | string | App ID | | page | query | No | integer | Page number (default: 1) | | per_page | query | No | integer | Items per page (default: 20, max: 100) | ## Request body Not documented in the OpenAPI contract. ## Responses | Status | Description | Content | | --- | --- | --- | | 200 | Public folders retrieved successfully | application/json (object) | | 400 | Invalid request | application/json (object) | | 500 | Internal server error | application/json (object) | ### 200 - object #### Public 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" } ``` ### 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}/folders/public` - Operation ID: Not documented in the OpenAPI contract. - Stable operation key: `dam-api:GET:/api/v1/{app_id}/folders/public` - OpenAPI tag: Folders - OpenAPI summary: Get Public Folders