---
title: "Make Controller download a File from a given URL."
slug: "make-controller-download-a-file-from-a-given-url-1"
updated: 2026-03-02T22:30:52Z
published: 2026-03-02T22:35:55Z
canonical: "support.appgate.com/make-controller-download-a-file-from-a-given-url-1"
---
> ## Documentation Index
> Fetch the complete documentation index at: https://support.appgate.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Make Controller download a File from a given URL.
Post/files
Make the current Controller download a File from a given URL. Note that the File is downloaded and stored only on the current Controller, not synced between Controllers.
SecurityHTTPType bearer
Body parametersobject urlstring Required
The URL for Controller to download the File from.
Examplehttps://s3.eu-central-1.amazonaws.com/appgate/appgate-appliance.img.zip
filenamestring Required
The filename to save the File as.
Exampleappgate-appliance.img.zip
Responses202
The request is accepted and the download has started. The status of the File can be followed via 'GET files/' call after this.
400
JSON error. Check the JSON format.
object
Generic HTTP error.
idstring
Machine readable error code.
messagestring
Human readable error details.
401
Token error. Login again.
object
Generic HTTP error.
idstring
Machine readable error code.
messagestring
Human readable error details.
403
Insufficient permissions to access this resource.
object
Generic HTTP error.
idstring
Machine readable error code.
messagestring
Human readable error details.
406
Invalid 'Accept' header.
object
Generic HTTP error.
idstring
Machine readable error code.
messagestring
Human readable error details.
409
The submitted resource conflicts with another.
object
Generic HTTP error.
idstring
Machine readable error code.
messagestring
Human readable error details.
422
Request validation error. Check "errors" array for details.
Expand Allobject
Http 422 error for object validation.
idstring
Machine readable error code.
messagestring
Human readable error details.
errors Array of object
List of fields with validation errors.
object fieldstring
Name of the field that failed validation.
Examplename
messagestring
Failure reason.
Examplemay not be null
500
Unexpected server side error.
object
Generic HTTP error.
idstring
Machine readable error code.
messagestring
Human readable error details.