Upload Cloud Files
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.
Authorization
bearer In: header
Header Parameters
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
}