Get Media Url
GET
/platform/v1/media/{media_id}/url
const url = 'https://example.com/platform/v1/media/example/url?channel_id=1';const options = {method: 'GET', headers: {'X-API-Key': 'example'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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.
Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” media_id
required
Media Id
string
Query Parameters
Section titled “Query Parameters ” channel_id
required
Channel Id
integer
Header Parameters
Section titled “Header Parameters ” X-API-Key
required
X-Api-Key
string
Responses
Section titled “ Responses ”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
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>
ValidationErrorobject
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" } ]}