POST api/Village/{village}/Folder

Create a new document folder for the village

Request Information

URI Parameters

Name	Description	Type	Additional information
village		string	None.

Body Parameters

VillageDocumentFolderUpdateModel

Name	Description	Type	Additional information
Id	Folder ID	globally unique identifier	None.
Name	Folder Name	string	None.
Description	Folder Description	string	None.
ParentFolderId	Parent Folder ID (if sub-folder)	globally unique identifier	None.
FolderType	What types of things can be added to this folder	DocumentFolderType	None.
Sequence	What order the folder should appear in, if not alphabetical (system folders are in specific order)	integer	None.

Request Formats

application/json, text/json

Sample:

{
  "Id": "fcc65114-0247-4e34-ab96-b5ec62cd91c3",
  "Name": "sample string 2",
  "Description": "sample string 3",
  "ParentFolderId": "a0217629-0c5e-4908-bd39-e1e274335d47",
  "FolderType": 1,
  "Sequence": 4
}

application/xml, text/xml

Sample:

<VillageDocumentFolderUpdateModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CaringVillage.Shared.Implementation.Models">
  <Description>sample string 3</Description>
  <FolderType>Files</FolderType>
  <Name>sample string 2</Name>
  <ParentFolderId>a0217629-0c5e-4908-bd39-e1e274335d47</ParentFolderId>
  <Sequence>4</Sequence>
  <Id>fcc65114-0247-4e34-ab96-b5ec62cd91c3</Id>
</VillageDocumentFolderUpdateModel>

multipart/form-data

Sample:

Failed to generate the sample for media type 'multipart/form-data'. Cannot use formatter 'MultipartMediaTypeFormatter' to write type 'VillageDocumentFolderUpdateModel'.

Response Information

Resource Description

VillageDocumentFolderModel

Name	Description	Type	Additional information
IsDefault	True if the folder is a default (system-defined) folder, false if it's a user-created folder	boolean	None.
Created	DateTime the folder was created	date	None.
LinkCount	# of Links in the folder	integer	None.
FileCount	# of Documents in the folder	integer	None.
VillageId	Village ID	globally unique identifier	None.
Id	Folder ID	globally unique identifier	None.
Name	Folder Name	string	None.
Description	Folder Description	string	None.
ParentFolderId	Parent Folder ID (if sub-folder)	globally unique identifier	None.
FolderType	What types of things can be added to this folder	DocumentFolderType	None.
Sequence	What order the folder should appear in, if not alphabetical (system folders are in specific order)	integer	None.

Response Formats

application/json, text/json

Sample:

{
  "IsDefault": true,
  "Created": "2025-06-03T04:37:01.141+00:00",
  "LinkCount": 3,
  "FileCount": 4,
  "VillageId": "1f72d26f-d7fc-4c69-89bb-272e397be9d6",
  "Id": "38ce00a5-1a6b-4b37-96fd-ea3eb3e64e6f",
  "Name": "sample string 7",
  "Description": "sample string 8",
  "ParentFolderId": "e40a198d-246c-461f-a77d-b459977113e5",
  "FolderType": 1,
  "Sequence": 9
}

application/xml, text/xml

Sample:

<VillageDocumentFolderModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CaringVillage.Shared.Implementation.Models">
  <Description>sample string 8</Description>
  <FolderType>Files</FolderType>
  <Name>sample string 7</Name>
  <ParentFolderId>e40a198d-246c-461f-a77d-b459977113e5</ParentFolderId>
  <Sequence>9</Sequence>
  <Id>38ce00a5-1a6b-4b37-96fd-ea3eb3e64e6f</Id>
  <Created>2025-06-03T04:37:01.1413352+00:00</Created>
  <FileCount>4</FileCount>
  <IsDefault>true</IsDefault>
  <LinkCount>3</LinkCount>
  <VillageId>1f72d26f-d7fc-4c69-89bb-272e397be9d6</VillageId>
</VillageDocumentFolderModel>