Import media from URL

Downloads an image (JPEG, PNG, WEBP, GIF, max 50 MB), video (MP4, MOV, WEBM, max 200 MB) or document from a public URL into the media library.

Requires the publish scope.

POST /media/import

Import media from URL

cURL

curl --request POST \
  --url https://api.autoadify.com/v1/media/import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "<string>",
  "fileName": "<string>",
  "altText": "<string>"
}
'

201

{
  "id": "<string>",
  "type": "image",
  "status": "pending",
  "fileName": "<string>",
  "mimeType": "<string>",
  "sizeBytes": 0,
  "url": "<string>",
  "thumbnailUrl": "<string>",
  "width": 0,
  "height": 0,
  "durationSeconds": 0,
  "altText": "<string>",
  "description": "<string>",
  "createdAt": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

An API key from Autoadify → Settings → API & MCP, sent as Authorization: Bearer aak_live_….

Body

application/json

url · string<uri> · required

Public http(s) URL of an image, video or PDF.

fileName · string

Required string length: 1 - 255

altText · string

Accessibility text; published where the platform supports it.

Maximum string length: 1000

Response

201

application/json

The imported file, ready to attach.

id · string · required

Use in mediaIds when creating a post.

type · enum<string> · required

Available options: image, gif, video, document, audio

status · enum<string> · required

Available options: pending, ready, failed

fileName · string | null · required

mimeType · string | null · required

sizeBytes · integer | null · required

Required range: -9007199254740991 <= x <= 9007199254740991

url · string | null · required

thumbnailUrl · string | null · required

width · integer | null · required

Required range: -9007199254740991 <= x <= 9007199254740991

height · integer | null · required

Required range: -9007199254740991 <= x <= 9007199254740991

durationSeconds · integer | null · required

Required range: -9007199254740991 <= x <= 9007199254740991

altText · string | null · required

description · string | null · required

What the file shows, from Autoadify's vision pass; null until it has run.

createdAt · string<date-time> · required