Overview
public. Retrieve file attachment content
Uri Parameters
| Name | Type | Description |
| Fileid | Int | Identifies a file by ID |
| Filename | String | "=" followed by a double uri-encoded file name |
Query Parameters
| Name | Type | Description |
| Format | {jpg, png, bmp, gif}? | Convert output to given type. Default is to use original type. |
| Height | Int? | Height of the image |
| Ratio | {fixed, var}? | Fixed preserves aspect ratio by applying height and width as bounding maximums rather than absolute values. Variable will use the width and height given. Default: fixed |
| Redirects | Int? | If zero, do not follow page redirects (only applies when {pageid} is present). |
| Revision | String? | File revision to retrieve. 'head' by default will retrieve latest revision. positive integer will retrieve specific revision |
| Size | {original, thumb, webview, bestfit, custom}? | Return a resized image from one of the preset cached sizes. Use 'thumb' or 'webview' to return a smaller scaled image. Use 'bestfit' along with height/width to return one of the known sizes being at least the size given. Default: original |
| Width | Int? | Width of the image |
Return Codes
| Name | Value | Description |
| BadRequest | 400 | Invalid input parameter or request body |
| Forbidden | 403 | Read access to the page is required |
| NotFound | 404 | Requested file could not be found |
| NotImplemented | 501 | Requested operation is not currently supported |
| Ok | 200 | The request completed successfully |
Implementation Notes
This feature is identical to GET:files/{fileid}; refer to this feature for more information. The {filename} uri parameter is not used and is intended for informational purposes only.