Import Remote URL

POST

/imports

Downloads media from a verified remote URL with strict SSRF defenses, DNS rebinding mitigation, streaming byte limits, and policy validation.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Import completed synchronously

Bodyapplication/json

🟠400BadRequest

🟠422Unprocessable

Request Example

Shell

JavaScript

Java

Swift

curl --location '/imports' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "url": "http://example.com",
    "privacy": "public",
    "filename": "string"
}'

Response Example

200 - Example 1

{
    "job_id": "string",
    "status": "string",
    "asset": {
        "id": "asset_01HXYZ...",
        "status": "active",
        "filename": "hero.png",
        "content_type": "image/png",
        "size": 245817,
        "checksum_sha256": "string",
        "privacy": "public",
        "direct_url": "https://files.media2url.com/media/hero.png",
        "share_url": "https://media2url.com/m/hero",
        "temporary": true,
        "expires_at": "2019-08-24T14:15:22.123Z",
        "trial_remaining": 0,
        "embeds": {
            "markdown": "string",
            "html": "string",
            "css": "string"
        },
        "created_at": "2019-08-24T14:15:22.123Z"
    }
}

Modified at 2026-10-11 18:32:15

Create Folder

Get Job Status