Exposes the article category api to widgets,themes and automation.
Methods
Create
Create Overload 1
Velocity
#set($articleCategoryResponse = $articles_v1_articleCategories.Create($articleId, $categoryId))
JavaScript
var articleCategoryResponse = articles_v1_articleCategories.Create(articleId, categoryId);
Parameters
| Name | Type | Description | Required | Default | Options |
|---|---|---|---|---|---|
| articleId | Guid | Id of the article the category is assigned. | Required | ||
| categoryId | Int32 | Id of the category assigned to the article. | Required |
Create Overload 2
Velocity
#set($articleCategoryResponse = $articles_v1_articleCategories.Create($articleId, $categoryId, "%{ RemoveSortOrder = $removeSortOrderArg, SortOrder = $sortOrderArg }"))JavaScript
var articleCategoryResponse = articles_v1_articleCategories.Create(articleId, categoryId, { RemoveSortOrder: removeSortOrderArg, SortOrder: sortOrderArg });Parameters
| Name | Type | Description | Required | Default | Options |
|---|---|---|---|---|---|
| articleId | Guid | Id of the article the category is assigned. | Required | ||
| categoryId | Int32 | Id of the category assigned to the article. | Required | ||
| options | Options | Set of optional parameters including: | Required | ||
| RemoveSortOrder | Int32 | Removes the SortOrder of the article within the category. | Optional | ||
| SortOrder | Int32 | The order in which the article will appear in the article list within the category. | Optional |
Returns
Delete
Velocity
#set($additionalInfoResponse = $articles_v1_articleCategories.Delete($articleId, $categoryId))
JavaScript
var additionalInfoResponse = articles_v1_articleCategories.Delete(articleId, categoryId);
Parameters
| Name | Type | Description | Required | Default | Options |
|---|---|---|---|---|---|
| articleId | Guid | Id of the article the category is assigned. | Required | ||
| categoryId | Int32 | Id of the category assigned to the article. | Required |
Returns
Get
Velocity
#set($articleCategoryResponse = $articles_v1_articleCategories.Get($articleId, $categoryId))
JavaScript
var articleCategoryResponse = articles_v1_articleCategories.Get(articleId, categoryId);
Parameters
| Name | Type | Description | Required | Default | Options |
|---|---|---|---|---|---|
| articleId | Guid | Id of the article the category is assigned. | Required | ||
| categoryId | Int32 | Id of the category assigned to the article. | Required |
Returns
List
List Overload 1
Velocity
#set($pagedListResponse = $articles_v1_articleCategories.List($categoryId))
JavaScript
var pagedListResponse = articles_v1_articleCategories.List(categoryId);
Parameters
| Name | Type | Description | Required | Default | Options |
|---|---|---|---|---|---|
| categoryId | Int32 | Id of the category assigned to the article. | Required |
List Overload 2
Velocity
#set($pagedListResponse = $articles_v1_articleCategories.List($categoryId, "%{ IncludeArticleTypeIds = $includeArticleTypeIdsArg, IncludeUnpublished = $includeUnpublishedArg, PageIndex = $pageIndexArg, PageSize = $pageSizeArg, SortBy = $sortByArg, SortOrder = $sortOrderArg }"))JavaScript
var pagedListResponse = articles_v1_articleCategories.List(categoryId, { IncludeArticleTypeIds: includeArticleTypeIdsArg, IncludeUnpublished: includeUnpublishedArg, PageIndex: pageIndexArg, PageSize: pageSizeArg, SortBy: sortByArg, SortOrder: sortOrderArg });Parameters
| Name | Type | Description | Required | Default | Options |
|---|---|---|---|---|---|
| categoryId | Int32 | Id of the category assigned to the article. | Required | ||
| options | Options | Set of optional parameters including: | Required | ||
| IncludeArticleTypeIds | String | A comma-separated list of article type ids to filter the articles by. | Optional | ||
| IncludeUnpublished | Boolean | Option to include unpublished articles in the result set. | Optional | ||
| PageIndex | Int32 | The page index to return based on page size. This value is 'zero' based and defaults to zero. | Optional | ||
| PageSize | Int32 | The total amount of article categories to return per paged request. The default is 20, the maximum is 100. | Optional | ||
| SortBy | String | The sort option for the articles categories. | Optional | SortOrder | |
| SortOrder | String | The direction to sort the article categories by based on the current SortBy options. The options are 'Ascending' or 'Descending'. 'Ascending' is the default. | Optional |