Skip to main content
POST
/
api
/
media
/
inspect
Inspect media metadata
curl --request POST \
  --url https://convertly.sh/api/media/inspect \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file' \
  --form 'sourceUrl=<string>' \
  --form async=false \
  --form background=true
{
  "media": {
    "filename": "<string>",
    "mimeType": "<string>",
    "sizeBytes": 123,
    "kind": "<string>",
    "format": "<string>",
    "width": 123,
    "height": 123,
    "duration": 123,
    "bitrateKbps": 123,
    "streams": [
      {}
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.convertly.sh/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Dashboard-generated Convertly API key.

Body

multipart/form-data

Provide either file or sourceUrl.

file
file

Multipart upload input.

sourceUrl
string<uri>

Remote HTTP(S) file input. Use instead of file for single-file tools.

async
enum<string>
default:false

Set true to queue the media tool as a background job.

Available options:
true,
false
background
enum<string>

Alias for async=true.

Available options:
true,
false

Response

Media metadata or queued media tool job

media
object
required