POST api/folders/{id}?name={name}&description={description}

Creates a new folder under a specified parent node.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
id

The internal node ID of the parent container (e.g., folder or workbox) where the new folder will be created.

integer

Required

name

The name of the new folder. Must be non-empty and unique within the parent container.

string

Required

description

Optional description for the new folder.

string

Required

Body Parameters

None.

Response Information

Resource Description

On success: HTTP 201 Created. On failure: HTTP 400 Bad Request if the name is missing or already exists, or 403 Forbidden if access is denied.

IHttpActionResult

None.

Response Formats

application/json, text/json, application/scim+json

Sample:

Sample not available.