COcontentstudio
📁 Content Library

List media folders

Changed on

Returns every media-library folder in the workspace. Folders the caller cannot access (shared/global folders without the access_shared_folder permission) are omitted. An empty library returns an empty array, not an error.

get/api/v1/workspaces/{workspace_id}/media/folders

Request

  • Base URL
    https://api.contentstudio.io
  • URL
    https://api.contentstudio.io/api/v1/workspaces/{workspace_id}/media/folders
  • Auth
    API key in header X-API-Key

Path parameters

workspace_idstring required
Example:610a1e660cb41530ca40d372

Response

Folders retrieved

statusboolean
messagestring

Example response

{
  "status": true,
  "message": "Media folders retrieved successfully.",
  "folders": [
    {
      "id": "625d06734ceb636c2f5e7743",
      "folder_name": "Campaign assets",
      "workspace_id": "610a1e660cb41530ca40d372",
      "is_root": true
    }
  ]
}

Changes