This is version . It is not the current version, and thus it cannot be edited.
[Back to current version]   [Restore this version]

If you are reading this, you are likely wanting a well documented published API to reference. You won't find that here. Its our opinion that the admin WebInterface provides a working example that is easily watched to see the commands its issuing for the documentation. If you want to know how to make a user using a web call, enable the network monitoring in Chrome/Safari/FireFox/Edge and make a user. Then its all detailed out in the network requests created.

Here are a few examples here to get you started though, and we may add to this list in the future too.

(The attachments tab at the top contains the sample files.)

Making a new User with VFS#

Builds a brand new user, or replaces an existing one entirely.

curl -d command=setUserItem -d data_action=replace -d xmlItem=user -d serverGroup=MainUsers -d username=curl_user --data-urlencode user@user.xml --data-urlencode vfs_items@vfs_items.xml --data-urlencode permissions@permissions.xml http://crushadmin:pass@
(long line, so get it all)

Updating a user#

Fills in the missing properties, doesn't alter the VFS. The VFS is an all or nothing approach. The above we did all, this one we are doing nothing. The password is always required, and in this case we are just updating the user with the items in the user.xml, but not replacing items that the user already has.

curl -d command=setUserItem -d data_action=update -d xmlItem=user -d serverGroup=MainUsers -d username=curl_user --data-urlencode user@user.xml http://crushadmin:pass@
(long line, so get it all)

Update/add to VFS of a user

This will update the VFS, either replacing an existing item, or adding a new item if it doesn't exist:
curl -d command=setUserItem -d data_action=update_vfs -d xmlItem=user -d serverGroup=MainUsers -d username=user1 -d vfs_items@vfs_items.XML -d permissions@permissions.XML -u crushadmin:passw

Delete VFS item from a user

This will remove a VFS item (so don't pass in a full permissions or vfs_items object or you would remove everything):
curl -d command=setUserItem -d data_action=update_vfs_remove -d xmlItem=user -d serverGroup=MainUsers -d username= user1 -d vfs_items@vfs_items.XML -d permissions@VFS.XML -u crushadmin:pass

Add new attachment

Only authorized users are allowed to upload new attachments.

List of attachments

Kind Attachment Name Size Version Date Modified Author Change note
permissions.xml 0.2 kB 1 09-Oct-2016 18:14 Ben Spink
user.xml 0.2 kB 1 09-Oct-2016 18:14 Ben Spink
vfs_items.xml 0.3 kB 1 09-Oct-2016 18:14 Ben Spink
« This particular version was published on 04-Nov-2016 07:38 by Ben Spink.
G’day (anonymous guest)


New: CrushFTPv9#


CrushFTP8 | What's New

Referenced by

JSPWiki v2.8.2