Docs
Log inStart free
API referenceMedia

Import an external asset

Download an EXTERNAL url (a discovery result, a file on the web) and re-host it on Typecut storage as a library asset with provenance + dimensions, captioned on ingest.

Free. Use this, not the raw provider url, before building a scene on found material — provider links expire. Contrast POST /media, which records a url you host yourself without copying it.

POST
/media/import

Authorization

bearerAuth
AuthorizationBearer <token>

Typecut API key. Generate one in app.typecut.ai → Settings → API keys. Send as Authorization: Bearer tc_live_….

In: header

Request Body

application/json

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://example.com/media/import" \  -H "Content-Type: application/json" \  -d '{    "url": "http://example.com"  }'
{
  "data": {
    "asset_id": "b4695157-0d1d-4da0-8f9e-5c53149389e4",
    "url": "string",
    "content_type": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}

Add media to the library POST

Record an already-hosted asset URL into the project media library.

Ingest a video link (admin-only) POST

ADMIN-ONLY. Download a public video from a link — X/Twitter, TikTok, Reddit, Instagram, a direct file, or a file already on Typecut storage — and host it as a library video with poster, subtitles and source metadata, ready for analysis.