POST api/Village/{village}/Link

Create a link.

Request Information

URI Parameters

Name	Description	Type	Additional information
village		string	None.

Body Parameters

VillageLinkCreateModel

Name	Description	Type	Additional information
VillageId	The ID of the village in which the link was uploaded	globally unique identifier	None.
FolderId	Folder ID of the folder to which the link belongs	globally unique identifier	None.
DisplayName	The link's Display Name / Title	string	None.
Url	The link URL	string	None.
CategoryId	Link Category ID	globally unique identifier	None.

Request Formats

application/json, text/json

Sample:

{
  "VillageId": "4f2e4023-2a6a-405a-9cc5-69d79310162b",
  "FolderId": "14b55cbc-dc12-40a4-a861-8ee15164181f",
  "DisplayName": "sample string 2",
  "Url": "sample string 3",
  "CategoryId": "c55fa19f-8812-4430-a3c7-54da4fd3c0fd"
}

application/xml, text/xml

Sample:

<VillageLinkCreateModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CaringVillage.Shared.Implementation.Models">
  <CategoryId>c55fa19f-8812-4430-a3c7-54da4fd3c0fd</CategoryId>
  <DisplayName>sample string 2</DisplayName>
  <FolderId>14b55cbc-dc12-40a4-a861-8ee15164181f</FolderId>
  <Url>sample string 3</Url>
  <VillageId>4f2e4023-2a6a-405a-9cc5-69d79310162b</VillageId>
</VillageLinkCreateModel>

multipart/form-data

Sample:

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

Response Information

Resource Description

VillageLinkModel

Name	Description	Type	Additional information
Id	Unique ID of the link	globally unique identifier	None.
Updated	Date/Time the file was most recently uploaded/updated	date	None.
UpdatedBy	Name of the user who most recently uploaded/updated the file	string	None.
UpdatedById	Unique ID of the user who most recently uploaded/updated the file	globally unique identifier	None.
Category	Link category name (if applicable)	string	None.
Created	DateTime the link was created	date	None.
CreatedById	User ID of the user who created the link	globally unique identifier	None.
CreatedBy	Name of the user who created the link	string	None.
VillageId	The ID of the village in which the link was uploaded	globally unique identifier	None.
FolderId	Folder ID of the folder to which the link belongs	globally unique identifier	None.
DisplayName	The link's Display Name / Title	string	None.
Url	The link URL	string	None.
CategoryId	Link Category ID	globally unique identifier	None.

Response Formats

application/json, text/json

Sample:

{
  "Id": "d37cae8b-20b1-454b-87f3-361414ae8e4a",
  "Updated": "2025-06-03T04:28:33.004+00:00",
  "UpdatedBy": "sample string 3",
  "UpdatedById": "0b630fb4-5c65-4642-a539-8f6925697215",
  "Category": "sample string 5",
  "Created": "2025-06-03T04:28:33.004+00:00",
  "CreatedById": "91bfd27f-93bf-414b-870b-4d5094435ffe",
  "CreatedBy": "sample string 8",
  "VillageId": "f2ab31a7-e523-4ccc-9ceb-72a7d304fa37",
  "FolderId": "1d3ecdd4-6822-4c7c-aa6c-b4267c9e72c5",
  "DisplayName": "sample string 10",
  "Url": "sample string 11",
  "CategoryId": "0d20bd45-2281-416c-9fe6-2b87b02c4fc0"
}

application/xml, text/xml

Sample:

<VillageLinkModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CaringVillage.Shared.Implementation.Models">
  <CategoryId>0d20bd45-2281-416c-9fe6-2b87b02c4fc0</CategoryId>
  <DisplayName>sample string 10</DisplayName>
  <FolderId>1d3ecdd4-6822-4c7c-aa6c-b4267c9e72c5</FolderId>
  <Url>sample string 11</Url>
  <VillageId>f2ab31a7-e523-4ccc-9ceb-72a7d304fa37</VillageId>
  <Category>sample string 5</Category>
  <Created>2025-06-03T04:28:33.0047607+00:00</Created>
  <CreatedBy>sample string 8</CreatedBy>
  <CreatedById>91bfd27f-93bf-414b-870b-4d5094435ffe</CreatedById>
  <Id>d37cae8b-20b1-454b-87f3-361414ae8e4a</Id>
  <Updated>2025-06-03T04:28:33.0047607+00:00</Updated>
  <UpdatedBy>sample string 3</UpdatedBy>
  <UpdatedById>0b630fb4-5c65-4642-a539-8f6925697215</UpdatedById>
</VillageLinkModel>