TagMangoTagMango Docs
Cloud

List Cloud Files

GET
/api/v1/external/cloud

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 fileType using AND; multiple file types match any supplied category.
  • Omitted pagination returns page 1 with 25 files. A page beyond the last returns an empty data array.

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.

AuthorizationBearer <token>

In: header

Query Parameters

limit?integer

Files per page. Defaults to 25; must be between 1 and 100.

Default25
Range1 <= value <= 100
page?integer

One-based page number. Values below 1 return 400 with "Page number must be greater than or equal to 1".

Range1 <= value
search?string

Case-insensitive literal substring of the original file name. Blank values are ignored.

Lengthlength <= 100
fileType?array<>

Comma-separated or repeated categories. Matches any supplied category; use file for PDFs and other documents. Omit for all categories.

Header Parameters

x-whitelabel-host*string

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
}