curl --request POST \
  --url https://api.mage.space/v1/uploads \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content_type": "video/mp4"
}
'

import { readFile } from 'node:fs/promises';
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

// Creates the ticket and uploads the file to it.
const ticket = await mage.uploads.upload(await readFile('clip.mp4'), {
  contentType: 'video/mp4',
});

console.log(ticket.url); // send this in any media field

from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

# Creates the ticket and uploads the file to it.
ticket = mage.uploads.upload("clip.mp4")  # a path, bytes, or a binary file

print(ticket["url"])  # send this in any media field

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({content_type: 'video/mp4'})
};

fetch('https://api.mage.space/v1/uploads', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "upload_url": "https://storage.googleapis.com/mage/temp/30d/uploads/user/video/6f1c.mp4?X-Goog-Signature=…",
  "method": "PUT",
  "headers": {
    "Content-Type": "video/mp4",
    "x-goog-content-length-range": "0,104857600"
  },
  "url": "https://cdn3.mage.space/temp/30d/uploads/user/video/6f1c.mp4",
  "content_type": "video/mp4",
  "max_bytes": 104857600,
  "upload_url_expires_at": "2026-09-17T15:07:48.000Z",
  "url_expires_at": "2026-10-17T14:52:48.000Z"
}

{
  "error": {
    "code": "invalid_request",
    "message": "`content_type` must be one of: image/jpeg, image/png, video/mp4, video/quicktime, video/webm, audio/mpeg, audio/mp3, audio/wav, audio/wave, audio/x-wav."
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "The API key is invalid or has been revoked."
  }
}

{
  "error": {
    "code": "payment_required",
    "message": "The Mage API and MCP server need a successful payment on this account first: buy any Gem pack or start a plan at https://www.mage.space/gems, then retry. Signup bonus Gems work in the Mage app only."
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Something went wrong on our side. Retry, and contact support if it persists."
  }
}