REST API /tasks/create/file "file" parameter documents appear incorrect

[woanware]

The REST API docs for the "/tasks/create/file" method state:
"file (required) - path to the file to submit"

I have only managed to get this method to work the the "requests" python library by forming the request like so:

import requests
files = {'file': open('/home/user/bad.exe', 'rb')}
r = requests.post('http://localhost:8090/tasks/create/file', files=files)

[jekil]

This is the way how requests post multipart data http://docs.python-requests.org/en/latest/user/quickstart/#post-a-multipart-encoded-file but the name of parameter inside multipart data is "file" as documented.

[woanware]

Sure no problem, though the documentation does not makes it clear that if you use the "requests" package then a multipart request will be performed rather than just supplying than an file path which is how the documentation reads.

[jekil]

To avoid misunderstanings i edited the documentation, thanks for the feedback.

[woanware]

Perfect. Thanks!