MKCOL Method
MKCOL Method
This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.
The WebDAVMKCOL method creates a new collection at the location specified by the Request-Uniform Resource Identifier (URI). When invoked without a request body, the collection will be created without member resources. When used with a request body, you can create members and properties on the collections or members.
The MKCOL method may be included in the scope of a transaction by submitting a Transaction Header with a lock token that corresponds to that transaction.
Note See Authentication and Security Using WebDAV for more information.
The list of WebDAV Protocol Status Codes in the following table is not comprehensive. For information about 500-level status codes, see WebDAV Status Codes: 500s.
Status Codes
| Status Code | Meaning |
|---|---|
| 201 (Created) | The collection was created. |
| 401 (Access Denied) | Resource requires authorization or authorization was denied. |
| 403 (Forbidden) | The server does not allow collections to be created at the specified location, or the parent collection of the specified request URI exists but cannot accept members. |
| 405 (Method Not Allowed) | The MKCOL method can only be performed on a deleted or non-existent resource. |
| 409 (Conflict) | A resource cannot be created at the destination URI until one or more intermediate collections are created. |
| 415 (Unsupported Media Type) | The request type of the body is not supported by the server. |
| 507 (Insufficient Storage) | The destination resource does not have sufficient storage space. |
Example
The following example uses the WebDAVMKCOL method to create a collection called pub2/folder1/folder2 on the server www.contoso.com.
Request
MKCOL /pub2/folder1/folder2/ HTTP/1.1 Host: www.contoso.com Content-Type: text/xml Content-Length: XXX
Response
HTTP/1.1 201 Created
Related Topics
Send us your feedback about the Microsoft Exchange Server 2003 SDK.
This topic last updated: December 2002
Build: June 2007 (2007.618.1)
© 2003-2006 Microsoft Corporation. All rights reserved. Terms of use.