---
title: "Upload file to TeraBox"
method: POST
path: "/uploader/terabox"
tags: ["Uploader"]
---

# Upload file to TeraBox

`POST /uploader/terabox`

Upload a file to [TeraBox](https://www.terabox.com) and get a shareable link back.

Accepts either a **direct file upload** (`multipart/form-data`) or a **remote URL** (`application/json`).

### Limits
- Max file size: **100 MB**
- Blocked types: executables, scripts (`.exe`, `.sh`, `.js`, `.apk`, …)

### Share password
Pass an optional 4-character alphanumeric `password` to lock the share link.

## Request body

- object
  - `url` string, uri, required — Remote URL of the file to fetch and re-upload to TeraBox.
  - `filename` string — Override the filename saved on TeraBox. Defaults to the name inferred from the URL.
  - `password` string — Optional 4-character alphanumeric share password (e.g. `ab12`).

## Response `200`

File uploaded and shared successfully

- object
  - `creator` string
  - `ok` boolean
  - `message` string
  - `filename` string — Saved filename on TeraBox
  - `path` string — Full remote path on TeraBox
  - `size` integer — File size in bytes
  - `fs_id` integer — TeraBox file ID
  - `link` string, uri — Shareable TeraBox link
  - `shorturl` string — Short URL alias for the share link
  - `direct_url` string, uri — Proxied direct download URL
  - `password` string — Share password (only present if one was set)

## Other responses

- `400` — Bad request – no file/url provided, file too large, or blocked file type
- `500` — Server error
- `502` — TeraBox upload failed (upstream error)

---

[API](https://skmtc.dev/paxsenix/apis/paxsenix-api.md) · [All operations](https://skmtc.dev/paxsenix/apis/paxsenix-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/paxsenix/paxsenix-api/revisions/a09b8775685e/schema)