Get media
Return one media file by ID, including its URL, source, and usage count.
Authorization
ApiKeyAuth AuthorizationBearer <token>
PublishQ API key sent as Authorization: Bearer pq_live_....
In: header
Path Parameters
id*string
Format
uuidResponse Body
application/json
application/json
application/json
application/json
curl -X GET "https://publishq.com/api/v1/media/f6370ca1-1f47-4f68-be72-c1206913b326"{
"id": "f6370ca1-1f47-4f68-be72-c1206913b326",
"type": "IMAGE",
"url": "https://cdn.publishq.com/uploads/images/f6370ca1-1f47-4f68-be72-c1206913b326.png",
"source": "UPLOAD",
"created_at": "2026-03-28T16:25:41.000Z",
"usageCount": 3,
"folderPath": "Channel A/Shorts"
}{
"error": {
"title": "Unauthorized",
"status": 401,
"code": "missing_auth",
"message": "Missing Authorization header",
"instance": "/api/v1/posts"
}
}{
"error": {
"title": "Not Found",
"status": 404,
"code": "media_not_found",
"message": "Media not found",
"instance": "/api/v1/media"
}
}{
"error": {
"title": "Too Many Requests",
"status": 429,
"code": "rate_limit_exceeded",
"message": "Too Many Requests",
"instance": "/api/v1/media/f6370ca1-1f47-4f68-be72-c1206913b326",
"details": {
"retryAfter": 60
}
}
}List media GET
Return your uploaded and generated media files. You can filter by ID, type, and source before reusing them in posts.
Upload media POST
Upload a file smaller than 100 MB in a single request. It is the simplest way to upload: one call returns a media ID you can attach to posts. For bigger files, use Create media upload. Add `folderPath` to the query string to put the file in a folder.