Skip to content

Get Media Url

GET
/platform/v1/media/{media_id}/url
curl --request GET \
--url 'https://example.com/platform/v1/media/example/url?channel_id=1' \
--header 'X-API-Key: example'

Return Meta’s media metadata (short-lived URL + mime + size).

The channel token used to query Meta is NEVER included in the response.

media_id
required
Media Id
string
channel_id
required
Channel Id
integer
X-API-Key
required
X-Api-Key
string

Successful Response

Media type application/json
PlatformMediaUrlResponse

Response for GET /platform/v1/media/{media_id}/url.

Mirrors Meta’s metadata shape EXCEPT the channel token is never surfaced.

object
channel_id
required
Channel Id
integer
file_size
Any of:
integer
mime_type
Any of:
string
url
required
Url
string
Example generated
{
"channel_id": 1,
"file_size": 1,
"mime_type": "example",
"url": "example"
}

Validation Error

Media type application/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Example generated
{
"detail": [
{
"ctx": {},
"input": "example",
"loc": [
"example"
],
"msg": "example",
"type": "example"
}
]
}