List Cloud Files
Lists reusable files owned by your creator account. Use Upload Cloud Files to add a file.
- Results are newest first; files stored at the same instant keep a stable order.
- Files without a usable public URL, temporary or internal files, and files unavailable for reuse are omitted.
- Filename search is literal and case-insensitive. It combines with
fileTypeusing AND; multiple file types match any supplied category. - Omitted pagination returns page 1 with 25 files. A page beyond the last returns an empty
dataarray.
External access policy
An API key and an authorized white-label host are required. Both tier and plan requirements are enforced.
These requirements apply to the white-label creator for backend-to-backend access. TagMango platform access is not supported.
-
Plans: Unrestricted.
-
Tiers: Unrestricted.
Authorization
bearer In: header
Query Parameters
Files per page. Defaults to 25; must be between 1 and 100.
251 <= value <= 100One-based page number. Values below 1 return 400 with "Page number must be greater than or equal to 1".
1 <= valueCase-insensitive literal substring of the original file name. Blank values are ignored.
length <= 100Comma-separated or repeated categories. Matches any supplied category; use file for PDFs and other documents. Omit for all categories.
Header Parameters
Host name of the dashboard, ex: mydomain.tagmango.com
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api-prod-new.tagmango.com/api/v1/external/cloud" \ -H "x-whitelabel-host: string"{
"data": [
{
"fileName": "brand-kit.pdf",
"fileSize": 482193,
"contentType": "application/pdf",
"createdAt": "2026-09-15T11:12:10.000Z",
"url": "https://cdn.tagmango.com/assets/brand-kit-a1b2.pdf",
"fileType": "file"
}
],
"total": 42
}{
"code": 400,
"type": "Bad Request",
"statusMessage": "BAD_REQUEST",
"success": false,
"message": "Invalid request",
"result": "Invalid request"
}{
"code": 401,
"type": "Unauthorized",
"statusMessage": "UNAUTHORIZED",
"message": "Invalid token",
"result": "Invalid token",
"success": false
}{
"code": 403,
"type": "Forbidden",
"statusMessage": "FORBIDDEN",
"errorCode": "WORKSHOP_MANGO_FORBIDDEN",
"message": "You can not access this api with a TagMango account, only available for whitelabel hosts",
"result": "You can not access this api with a TagMango account, only available for whitelabel hosts",
"success": false
}{
"code": 429,
"type": "Too Many Requests",
"statusMessage": "TOO_MANY_REQUESTS",
"message": "Request limit exceeded. try after 10 seconds",
"result": "Request limit exceeded. try after 10 seconds",
"success": false
}