Description

Add a comment to a file or folder.

URL

All responses are in JSON format by default, to specify an XML response add ".xml" to the end of the method name (in this case "file_comment_list")

https://<yoursubdomain>.filetransfers.net/api/file_comment_add

Restrictions

The calling user must have:

  • Access to the location the requested file resides in.

Parameters

Bold indicates required

ParameterDescription
file_id ID of the file or folder being commented on.
comment The comment to be added.
api_key Your API Key.
timestamp The current time in Unix timestamp format.
signature Please see "User Authentication" for more information.

Sample Response

Successful response In JSON:

{"fileCommentAdd":{"file_id":"104565","comment":"I approve this.","user_id":23456}}

Successful response in XML:

<fileCommentAdd>
  <file_id>104565</file_id>
  <comment>I approve this.</comment>
  <user_id>23456</user_id>
</fileCommentAdd>

Error response In JSON:

{"error":{"title":"Authentication Failed","message":"Authentication parameters missing or invalid."}}

Error response In XML:

<error>
	<title>Authentication Failed</title>
 	<message>Authentication parameters missing or invalid.</message>
</error>

Want more info? Visit our Documents Library page to
get more in-depth info, like our Terms and Conditions.

GO
FileGenius Basic vs. Total
Compare Us - See How We Stack Up