TagMangoTagMango Docs
Cloud

Upload Cloud Files

POST
/api/v1/external/cloud

Uploads files to your TagMango Cloud storage and returns public URLs for later external API requests. Use List Cloud Files to find files already in storage.

  • Successful uploads are ready to use immediately and count against your storage quota.
  • Files are returned in the same order as their multipart parts.
  • Set each part's MIME type to one of the documented values; the file extension alone is not sufficient.
  • A non-multipart request returns 400 with Unsupported Content-Type. Expected multipart/form-data..
  • Maximum 5 files per request; maximum 100 MiB (104857600 bytes) per file and 100 MiB (104857600 bytes) combined file contents. Multipart boundaries and ordinary form fields are excluded from the combined limit.
  • Requests declaring Content-Length above 128 MiB (134217728 bytes), including multipart overhead and form fields, are rejected before parsing with 413 and the connection is closed. Requests without Content-Length still undergo streaming file-size checks.
  • Exact limits are accepted. Example accepted requests: 5 files of 20 MiB (20971520 bytes) each or one file of 100 MiB (104857600 bytes). Batches exceeding 100 MiB (104857600 bytes) combined must be split into separate requests.
  • Individual or combined size overflow returns 413. More than 5 files returns 400. Rejected uploads are stopped and cleaned up.
  • Uploads are not idempotent. If the connection is lost before a response arrives, list your files before retrying.

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

Header Parameters

x-whitelabel-host*string

Host name of the dashboard, ex: mydomain.tagmango.com

Request Body

multipart/form-data

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api-prod-new.tagmango.com/api/v1/external/cloud" \  -H "x-whitelabel-host: string" \  -F files="[\n  \"string\"\n]"
{
  "files": [
    {
      "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"
    }
  ]
}
{
  "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": 413,
  "type": "Payload Too Large",
  "statusMessage": "PAYLOAD_TOO_LARGE",
  "errorCode": "UPLOAD_CONTENT_LENGTH_EXCEEDED",
  "message": "Request Content-Length exceeds 128 MiB (134217728 bytes), including multipart overhead and form fields",
  "result": "Request Content-Length exceeds 128 MiB (134217728 bytes), including multipart overhead and form fields",
  "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
}