Skip to main content
POST
Import media from URL

Authorizations

Authorization
string
header
required

An API key from Autoadify → Settings → Developers, 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

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