Skip to main content
GET
Folder item behavior depends on folder media type:
  • slideshow folder → item IDs are slideshow IDs
  • ai_image, ai_video, and upload folders → item IDs are file IDs
Items are returned newest-created first. added_at remains available as folder-membership history.

Path Parameters

string
required
Folder UUID.

Query Parameters

string
Inclusive ISO-8601 lower bound on the media item’s created_at timestamp.
string
Inclusive ISO-8601 upper bound on the media item’s created_at timestamp.
number
default:"50"
Number of items to return (1-100).
number
default:"0"
Number of items to skip.

Error Responses

  • 400 invalid_query_parameter - invalid limit or offset
  • 422 invalid_path - folderId is not a valid UUID
  • 422 invalid_folder_media_type - folder media type is not supported by Partner folder APIs
  • 404 not_found - folder not visible in key scope
  • 401 - authentication failed (missing/invalid/revoked token)
  • 402 subscription_required - active Creator/Professional/Business plan required
  • 403 tier_not_allowed - Scheduler tier cannot use Partner API
  • 500 folder_items_list_failed - unexpected failure