Get file content
GET/file/:id
File Access
Retrieve a file. The file can be returned inline (e.g., displayed in the browser) or as an attachment for download (e.g., prompting a save dialog), based on the disposition parameter. The API can serve the file directly or redirect to the location of the file.
Request
Responses
- 200
- 206
- 302
- 400
- 401
- 403
- 404
- 416
- 429
- 500
Returns the requested file content or { "location": "http://location/of/file" }
Response Headers
Indicates that the server supports range requests for this file
The size of the returned content in bytes
The MIME type of the returned file
The date and time the file was last modified
Entity tag for cache validation
Partial Content - returned when Range header is present and valid
Response Headers
Indicates that the server supports range requests
Indicates the byte range returned (e.g., "bytes 200-1023/1024")
bytes 0-1023/2048The size of the returned partial content in bytes
The MIME type of the returned file
Redirects to file location
Bad Request - Invalid parameters or entity is not a MediaObject type
Not authenticated
Access token does not have the required scope
Entity not found
Range Not Satisfiable - the requested range is invalid
Response Headers
Indicates the total size of the file when range is not satisfiable
bytes */2048Rate limit exceeded
Response Headers
Request limit per time window
Requests remaining in current time window
Unix timestamp when the rate limit resets
Number of seconds to wait before retrying
Internal Server Error