Skip to content
AdVentur.aiAdVentur.aiAdVentur.ai Docs

import_media_from_url

posts:write

Copy an image or video from a public https link (straight to the file, not a web page) into the workspace, ready to post. Images up to 20 MB, video up to 300 MB; for bigger or local files use create_media_upload. Files count toward the workspace's storage; get_usage shows what's left.

Returns asset: pass it as media to create_draft_post or update_post. Video posts go to X, LinkedIn, Facebook Pages, Instagram (as a Reel), TikTok and YouTube (a Short when vertical and up to 3 minutes). MP4 works everywhere; LinkedIn takes MP4 only.

Input

  • urlstring (uri)required

    max length 2048

  • altTextstring

    max length 1000

Permission

Needs the posts:write scope: create drafts. It changes your workspace, so clients may ask you to confirm each call.

Example call

Your assistant sends this for you. It is shown so you can see the shape of a call, with placeholder values for the required fields.

tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "import_media_from_url",
    "arguments": {
      "url": "https://example.com"
    }
  }
}

Same action over the REST API

The tool runs POST /v1/orgs/{orgId}/marketing/media/import as the signed-in user, with the same validation, approval rules and limits. See it in the Media API reference.