Internal endpoint for worker-to-server file uploads

POST

https://api.mediashare.com/api/files/upload-from-worker

INTERNAL USE ONLY - Not for direct client use.

This endpoint is used in distributed architectures where the worker process runs
on a different server than the API. The worker uploads temporary files to the
API server using this endpoint.

Authentication

Requires X-Internal-Request header with the INTERNAL_SECRET environment variable.

Use Case

Worker downloads media from external URLs

Worker processes/converts media files

Worker uploads to API server for serving to platforms (e.g., TikTok PULL_FROM_URL)

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Header Params

Body Params multipart/form-dataRequired

Responses

🟢200

application/json

File uploaded successfully

Body

🟠400

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.mediashare.com/api/files/upload-from-worker' \
--header 'X-Internal-Request;' \
--header 'X-API-Key: <api-key>' \
--form 'file=@""' \
--form 'storageType=""'

Response Example

{
    "success": true,
    "url": "https://api.yourdomain.com/uploads/temp/file-123.jpg"
}

Modified at 2025-12-15 20:30:09

Get queue statistics

Error

Internal endpoint for worker-to-server file uploads

Authentication#

Use Case#

Request

Responses

Authentication

Use Case