POST v1/Article/{articleKey}/Description

Create a document description for an article. There can be multiple document descriptions for an article.

Roles Allowed

admin, editor

Request Information

URI Parameters

NameDescriptionTypeAdditional information
articleKey

Identifies the article the document description applies to

integer

Required

Body Parameters

The description to the associated with the article

DocumentDescriptionCreate
NameDescriptionTypeAdditional information
DocumentTypeId

integer

None.

DocumentDescriptionText

string

None.

Request Formats

application/json, text/json

Sample:
{
  "DocumentTypeId": 1,
  "DocumentDescriptionText": "sample string 2"
}

application/xml, text/xml

Sample:
<DocumentDescriptionCreate xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Bondi.Models.V3.ApiDto">
  <DocumentDescriptionText>sample string 2</DocumentDescriptionText>
  <DocumentTypeId>1</DocumentTypeId>
</DocumentDescriptionCreate>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

HTTP 201 with Created Description, HTTP 404 if article not found, HTTP 409 if validation fails

DocumentDescription
NameDescriptionTypeAdditional information
DocumentDescriptionId

integer

None.

DocumentTypeId

integer

None.

DocumentDescriptionText

string

None.

Response Formats

application/json, text/json

Sample:
{
  "DocumentDescriptionId": 1,
  "DocumentTypeId": 2,
  "DocumentDescriptionText": "sample string 3"
}

application/xml, text/xml

Sample:
<DocumentDescription xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Bondi.Models.V3.ApiDto">
  <DocumentDescriptionText>sample string 3</DocumentDescriptionText>
  <DocumentTypeId>2</DocumentTypeId>
  <DocumentDescriptionId>1</DocumentDescriptionId>
</DocumentDescription>