From: Brian Warner Date: Fri, 8 Feb 2008 03:10:28 +0000 (-0700) Subject: webapi.txt: document POST /uri?t=mkdir X-Git-Tag: allmydata-tahoe-0.8.0~107 X-Git-Url: https://git.rkrishnan.org/components/provisioning?a=commitdiff_plain;h=7dcb4ee62b002509418a1843ace9f165ba257429;p=tahoe-lafs%2Ftahoe-lafs.git webapi.txt: document POST /uri?t=mkdir --- diff --git a/docs/webapi.txt b/docs/webapi.txt index e4685e3b..7604ce42 100644 --- a/docs/webapi.txt +++ b/docs/webapi.txt @@ -200,13 +200,36 @@ g. creating a new directory PUT http://localhost:8123/uri?t=mkdir - in: (nothing) - out: directory write cap + in: (nothing) + out: directory write cap + + Create a new empty directory and return its URI as the HTTP response body. + This does not make the newly created directory visible from the virtual + drive, but you can use section 1.h. to attach it, or the convenience method + in section 2.XXX. + + POST http://localhost:8123/uri?t=mkdir + + in: (nothing) + out: directory write cap + + Just like the equivalent PUT form, but this can be called from an HTML + form. + + POST http://localhost:8123/uri?t=mkdir&redirect_to_result=true + + in: (nothing) + out: redirects to the /uri/$NEWDIRURI page + + This also creates an unlinked directory, but instead of returning the URI + as a string, this form will return an HTTP Redirect that takes you to the + new directory's HTML page, just as if you had directed your browser to + /uri/$NEWDIRURI . If you bookmark this page, you'll be able to get back to + the directory again in the future. + + This method is the recommended way to create a new root directory. There + is a "Create Directory" button on the Welcome page to invoke this action. - Create a new empty directory and return its URI as the HTTP response body. - This does not make the newly created directory visible from the virtual - drive, but you can use section 1.h. to attach it, or the convenience method - in section 2.XXX. h. attaching a file or directory as the child of an extant directory