Download the binary file associated with a content item. This endpoint uses the standard WebAPI authentication pipeline, making it the recommended method for headless or server-to-server file downloads where browser session cookies are not available.
When to use this endpoint
The ContentMediaUrl property returned by other content API responses points to an HTTP handler that does not process Authorization headers. While ContentMediaUrl works for logged-in browser users (via session cookies), headless API consumers will receive a 401 Unauthorized error. Use /api/content/{ContentID}/stream instead for reliable, token-authenticated file downloads.
ContentMediaUrl
Authorization
/api/content/{ContentID}/stream
Bearer YOUR_TOKEN
ContentID
Authorization: Bearer YOUR_TOKEN
https://your-site.com/api/content/4523/stream
A successful request returns the raw binary file content with an HTTP 200 OK status. The Content-Type header is set dynamically based on the file extension (e.g., application/pdf, image/png, application/vnd.openxmlformats-officedocument.wordprocessingml.document).
Content-Type
application/pdf
image/png
application/vnd.openxmlformats-officedocument.wordprocessingml.document
HTTP/1.1 200 OK Content-Type: application/pdf [Raw binary file data]
This endpoint does not return a JSON response envelope. The response body is the file itself.
While Axero does not enforce hard rate limits by default, we recommend the following best practices to ensure optimal performance:
Axero may implement temporary rate restrictions if excessive API usage affects overall site performance. For high-volume integrations, contact Axero to discuss your requirements.
is requesting access to a wiki that you have locked: https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/111533/rest-api-download-file
Your session has expired. You are being logged out.