Create an article
/articles
Request
-
fields: string
This parameter filters the fields returned in the response; look at the response schema to see the possible values. Only the specified fields are returned, which means that if no fields are specified, no fields are returned (useful to get only the links).
Format: ?fields=Attribute1,Attribute2
Format for fields in child resource and root fields: ?fields=Attribute1;Child:Attribute1,Attribute2Example:Attribute1;Child:Attribute1,Attribute2 -
onlyData: boolean
Prevents links from being returned in the response, defaults to false.Default Value:
false
- application/json
- multipart/form-data
object-
allTranslations: array
All Translations
Title:
All TranslationsRead Only:trueContains a collection of translations available of an article, if there are any. -
allVersions: array
All Versions
Title:
All VersionsRead Only:trueContains a collection of all versions of an article. -
answerId: integer
(int64)
Title:
Answer IDRead Only:trueThe unique identifier of an article in a locale. -
articleStatus:
articleStatus
-
autoCheckIn: boolean
Title:
Auto Check InRead Only:trueDefault Value:falseIndicates whether the article needs to be automatically checked in after saving it. -
autosave:
autosave
-
autosaveList: array
Autosave List
Title:
Autosave ListRead Only:trueContains a collection of autosaves that exist for an article, if there are any. -
basedLocale:
basedLocale
-
basedOnVersion: string
Title:
Based On VersionRead Only:trueMaximum Length:50If this article version is a localization, this field may contain the version of the article the localization was created from. -
categories: array
Categories
Title:
CategoriesThe list of categories associated with the article. -
checkedOut: boolean
Title:
Checked OutRead Only:trueDefault Value:falseThe date and time when an author has checked out or locked the document for editing. -
checkedOutBy:
checkedOutBy
-
contentBody(required): object
Content Body
Title:
Content BodyContents of the article. -
contentType(required):
contentType
-
createDate: string
(date)
Title:
Create DateRead Only:trueThe date and time when this article was originally created. -
creator:
creator
-
dateAdded: string
(date)
Title:
Date AddedRead Only:trueThe date and time when this article version was created. -
dateModified: string
(date)
Title:
Date ModifiedRead Only:trueThe date and time when this article was last modified. -
displayEndDate: string
(date)
Title:
Display End DateThe date and time when the article will stop being available to display to end-users. -
displayReviewDate: string
(date)
Title:
Display Review DateThe date and time when the article requires a review by an author capable of performing the review. -
displayStartDate: string
(date)
Title:
Display Start DateThe date and time when the article will be available to display to end-users.. -
documentId: string
Title:
Document IDRead Only:trueThe unique identifier of an article most usable for humans. -
externalAssociations: object
Content External Associations
Title:
Content External AssociationsRead Only:trueAdditional Properties Allowed: ContentExternalAssociationBOThis field will return external associations of content such as a reference to an SR this article was created from. -
isForEdit: boolean
Title:
Is For EditRead Only:trueDefault Value:falseIndicates whether the purpose of the request was to get an editable version of an article. Default value is false. -
lastModifiedDate: string
(date)
Title:
Last Modified DateRead Only:trueThe date and time when this article was last modified. -
lastModifier:
lastModifier
-
latestContent:
latestContent
-
links: array
Links
Title:
LinksRead Only:trueREST API canonical and/or collection links for this Singular Resource -
locale(required):
locale
-
owner:
owner
-
pending: boolean
Title:
PendingRead Only:trueDefault Value:falseIndicates whether this article version is scheduled to go live in the future. The value is false for most article versions. -
products: array
Products
Title:
ProductsThe list of products associated with the article. -
publishDate: string
(date)
Title:
Publish DateRead Only:trueThe date and time when this article version was published. -
published: boolean
Title:
PublishedRead Only:trueDefault Value:falseIndicates whether this article version is published. Default value is false for all versions other than the published version, if there is one. -
publishedContent:
publishedContent
-
publishedVersion: string
Title:
Published VersionRead Only:trueMaximum Length:50If this article has a published version in the requested locale, this fields will contain the version number of the published article version. -
rating:
rating
-
ratingsAggregate:
ratingsAggregate
-
reasonForEdit: string
Title:
Reason For EditMaximum Length:2000Reasons for editing or creating an article version. -
recordId: string
Title:
Record IDRead Only:trueThe unique identifier of the article. This ID is the same in all versions in all locales of the article and is recommended for programmatic use. -
reviewInformation:
reviewInformation
-
schemaAttributes: array
Schema Attributes
Title:
Schema AttributesRead Only:trueReturns information about the schema of an article. -
sourceMetadata:
sourceMetadata
-
title: string
Title:
TitleRead Only:trueMaximum Length:4000The title of the document. -
userGroups: array
User Groups
Title:
User GroupsThe user groups assigned to the content. Only the members of the assigned user group will have access to the content. Default value is Everyone. -
version: string
Title:
VersionRead Only:trueMaximum Length:50The version of the article. -
versionId: string
Title:
Version IDRead Only:trueMaximum Length:64The unique identifier of the specific version of an article in a specific locale. You cannot use this field in queries made using q query parameter. -
versionState: string
Title:
Version StateRead Only:trueThe state of a version, possible values are SCHEDULED, LIVE, EXPIRED, DRAFT. -
views: array
Views
Title:
ViewsRead Only:trueThe views assigned to the content. The user who has the view assigned to the content or the content type in which the content is saved can only access the content. -
workflowStep:
workflowStep
arrayAll Translationstrue-
Array of:
object ContentDataBO
Documentation for BO mode: ContentDataBO
arrayAll Versionstrue-
Array of:
object ContentKeyBO
Documentation for BO mode: ContentKeyBO
The article status.
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+in+('DRAFT', 'WORK_IN_PROGRESS')http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT' and contentState eq 'LATEST'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+eq+'IM_NULL_ARTICLE_STATUS'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+in+('IM_NULL_ARTICLE_STATUS', 'DRAFT')
The service response matches any Content object (PUBLISHED by default) with article status specified in the request if you pass the articleStatus.refKey parameter.
Example URIs for the articleStatus parameter are as follows:
OR
The following example URIs returns Content objects whose contentState is LATEST:
The following example URI returns Content objects with no article status assigned:
The following example URI returns Content objects with no article status assigned and Content objects with the Draft article status assigned:
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
-
object
ArticleStatusKeyBO
Documentation for BO mode: ArticleStatusKeyBO
-
Title:
Article StatusThe article status.
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+in+('DRAFT', 'WORK_IN_PROGRESS')http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT' and contentState eq 'LATEST'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+eq+'IM_NULL_ARTICLE_STATUS'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+in+('IM_NULL_ARTICLE_STATUS', 'DRAFT')
The service response matches any Content object (PUBLISHED by default) with article status specified in the request if you pass the
articleStatus.refKeyparameter.Example URIs for the articleStatus parameter are as follows:
OR
The following example URIs returns Content objects whose contentState is LATEST:
The following example URI returns Content objects with no article status assigned:
The following example URI returns Content objects with no article status assigned and Content objects with the Draft article status assigned:
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
-
object
ContentAutosaveKeyBO
-
Title:
AutosaveRead Only:trueautosave record.
arrayAutosave Listtrue-
object
LocaleKeyBO
Documentation for BO mode: LocaleKeyBO:
Localized Name of the Locale is currently NOT provided (i.e. The word Japanese is always in Japanese and never localized in say Arabic.)
-
Title:
Based LocaleThe source locale used to create the localized version of the document. This field is seen only if the content has a localized version.
arrayCategories-
Array of:
object CategoryItemKeyBO
Documentation for BO mode: CategoryItemKeyBO
The user or author who performed the last content checkout. The following are the subfields that can be used with checkedOutBy query parameter:
- checkedOutBy.recordId : The unique identifier of the checkedOutBy object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=checkedOutBy.recordId eq '{id}' - checkedOutBy.email : User's email.
- checkedOutBy.firstName : User's firstName.
- checkedOutBy.lastName : User's lastName.
- checkedOutBy.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
Checked Out ByRead Only:trueThe user or author who performed the last content checkout. The following are the subfields that can be used with checkedOutBy query parameter:
- checkedOutBy.recordId : The unique identifier of the checkedOutBy object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=checkedOutBy.recordId eq '{id}' - checkedOutBy.email : User's email.
- checkedOutBy.firstName : User's firstName.
- checkedOutBy.lastName : User's lastName.
- checkedOutBy.login : User's login.
- checkedOutBy.recordId : The unique identifier of the checkedOutBy object. For example, to request an article with unique id, submit a call using the URI:
objectContent BodyThe channel to which the content is categorized and saved. The following are the subfields that can be used with contentType query parameter:
- contentType.recordId : The unique identifier of the ContentType object.
- contentType.referenceKey : The reference key for the ContentType object. ContentType objects support multiple languages. This field can be used to identify the associated objects for all languages. For Example to request articles for content type FAQ, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=contentType.referenceKey eq 'FAQ' - contentType.allowRecommendations : The flag indicates whether the content type allows end users to create recommendations for its contents. This also indicates whether you can associate the recommended content with a content type.
-
object
ContentTypeKeyBO
Documentation for BO mode: ContentTypeKeyBO
-
Title:
Content TypeThe channel to which the content is categorized and saved. The following are the subfields that can be used with contentType query parameter:
- contentType.recordId : The unique identifier of the ContentType object.
- contentType.referenceKey : The reference key for the ContentType object. ContentType objects support multiple languages. This field can be used to identify the associated objects for all languages. For Example to request articles for content type FAQ, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=contentType.referenceKey eq 'FAQ' - contentType.allowRecommendations : The flag indicates whether the content type allows end users to create recommendations for its contents. This also indicates whether you can associate the recommended content with a content type.
The user who originally authored or created the document. The following are the subfields that can be used with creator query parameter:
- creator.recordId : The unique identifier of the creator object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=creator.recordId eq '{id}' - creator.email : User's email.
- creator.firstName : User's firstName.
- creator.lastName : User's lastName.
- creator.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
CreatorRead Only:trueThe user who originally authored or created the document. The following are the subfields that can be used with creator query parameter:
- creator.recordId : The unique identifier of the creator object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=creator.recordId eq '{id}' - creator.email : User's email.
- creator.firstName : User's firstName.
- creator.lastName : User's lastName.
- creator.login : User's login.
- creator.recordId : The unique identifier of the creator object. For example, to request an article with unique id, submit a call using the URI:
objectContent External Associationstrue-
object ContentExternalAssociationBO
Documentation for ContentExternalAssociationBO
The user or author who performed the last content modification. The following are the subfields that can be used with lastModifier query parameter:
- lastModifier.recordId : The unique identifier of the lastModifier object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=lastModifier.recordId eq '{id}' - lastModifier.email : User's email.
- lastModifier.firstName : User's firstName.
- lastModifier.lastName : User's lastName.
- lastModifier.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
Last ModifierRead Only:trueThe user or author who performed the last content modification. The following are the subfields that can be used with lastModifier query parameter:
- lastModifier.recordId : The unique identifier of the lastModifier object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=lastModifier.recordId eq '{id}' - lastModifier.email : User's email.
- lastModifier.firstName : User's firstName.
- lastModifier.lastName : User's lastName.
- lastModifier.login : User's login.
- lastModifier.recordId : The unique identifier of the lastModifier object. For example, to request an article with unique id, submit a call using the URI:
-
object
ContentKeyBO
Documentation for BO mode: ContentKeyBO
-
Title:
Latest ContentRead Only:trueLatest BO for this document.
arrayLinkstrueThe locale of the version of the document. The locale code represents the language and country associated with the Locale object. The following subfield can be used with locale query parameter:
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=locale.recordId eq 'es_ES'
-
object
LocaleKeyBO
Documentation for BO mode: LocaleKeyBO:
Localized Name of the Locale is currently NOT provided (i.e. The word Japanese is always in Japanese and never localized in say Arabic.)
-
Title:
LocaleThe locale of the version of the document. The locale code represents the language and country associated with the Locale object. The following subfield can be used with locale query parameter:
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=locale.recordId eq 'es_ES'
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
The user or author who owns or is responsible for the document. The following are the subfields that can be used with owner query parameter:
- owner.recordId : The unique identifier of the owner object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=owner.recordId eq '{id}' - owner.email : User's email.
- owner.firstName : User's firstName.
- owner.lastName : User's lastName.
- owner.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
OwnerRead Only:trueThe user or author who owns or is responsible for the document. The following are the subfields that can be used with owner query parameter:
- owner.recordId : The unique identifier of the owner object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=owner.recordId eq '{id}' - owner.email : User's email.
- owner.firstName : User's firstName.
- owner.lastName : User's lastName.
- owner.login : User's login.
- owner.recordId : The unique identifier of the owner object. For example, to request an article with unique id, submit a call using the URI:
arrayProducts-
Array of:
object ProductItemKeyBO
Documentation for BO mode: ProductItemKeyBO
-
object
ContentKeyBO
Documentation for BO mode: ContentKeyBO
-
Title:
Published ContentRead Only:truePublished BO for this document.
- CUSTOM(0)
- YES(1)
- YES_NO(2)
- THREE_STARS(3)
- FIVE_STARS(4)
-
object
DataFormBO
Documentation for BO mode: DataFormBO
-
Title:
RatingRead Only:trueDetermined whether it is a 5 star or Y/N type of rating.- CUSTOM(0)
- YES(1)
- YES_NO(2)
- THREE_STARS(3)
- FIVE_STARS(4)
-
object
AggregateFormResultsBO
Documentation for BO mode: AggregateFormResultsBO
-
Title:
Ratings AggregateRead Only:trueThe aggregate form results. This includes the average rating, the total responses, and the specific rating values for this article.
-
object
ContentReviewInformationBO
Content Review Information BO
-
Title:
Review InformationRead Only:trueReview information added after document marked as reviewed.
arraySchema Attributestrue-
Array of:
object SchemaAttributeBO
Documentation for BO mode: SchemaAttributeBO
-
object
ContentHistoryMetadataBO
Content History Metadata BO
-
Title:
sourceMetadataMetadata used to provide context to the action which created or modified this content.
arrayUser Groups-
Array of:
object UserGroupKeyBO
Documentation for BO mode: UserGroupKeyBO
arrayViewstrue-
Array of:
object ViewKeyBO
Documentation for BO mode: ViewKeyBO
-
object
WorkflowStepDataBO
Documentation for BO mode: WorkflowStepDataBO
-
Title:
Workflow StepRead Only:trueThe step of the workflow in which the document version currently exist.
object-
allTranslations: array
All Translations
Title:
All TranslationsRead Only:trueContains a collection of translations available of an article, if there are any. -
allVersions: array
All Versions
Title:
All VersionsRead Only:trueContains a collection of all versions of an article. -
answerId: integer
(int64)
Title:
Answer IDRead Only:trueThe unique identifier of an article in a locale. -
articleStatus:
articleStatus
-
autoCheckIn: boolean
Title:
Auto Check InRead Only:trueDefault Value:falseIndicates whether the article needs to be automatically checked in after saving it. -
autosave:
autosave
-
autosaveList: array
Autosave List
Title:
Autosave ListRead Only:trueContains a collection of autosaves that exist for an article, if there are any. -
basedLocale:
basedLocale
-
basedOnVersion: string
Title:
Based On VersionRead Only:trueMaximum Length:50If this article version is a localization, this field may contain the version of the article the localization was created from. -
checkedOut: boolean
Title:
Checked OutRead Only:trueDefault Value:falseThe date and time when an author has checked out or locked the document for editing. -
checkedOutBy:
checkedOutBy
-
contentType(required):
contentType
-
createDate: string
(date)
Title:
Create DateRead Only:trueThe date and time when this article was originally created. -
creator:
creator
-
dateAdded: string
(date)
Title:
Date AddedRead Only:trueThe date and time when this article version was created. -
dateModified: string
(date)
Title:
Date ModifiedRead Only:trueThe date and time when this article was last modified. -
displayEndDate: string
(date)
Title:
Display End DateThe date and time when the article will stop being available to display to end-users. -
displayReviewDate: string
(date)
Title:
Display Review DateThe date and time when the article requires a review by an author capable of performing the review. -
displayStartDate: string
(date)
Title:
Display Start DateThe date and time when the article will be available to display to end-users.. -
documentId: string
Title:
Document IDRead Only:trueThe unique identifier of an article most usable for humans. -
externalAssociations: object
Content External Associations
Title:
Content External AssociationsRead Only:trueAdditional Properties Allowed: ContentExternalAssociationBOThis field will return external associations of content such as a reference to an SR this article was created from. -
lastModifiedDate: string
(date)
Title:
Last Modified DateRead Only:trueThe date and time when this article was last modified. -
lastModifier:
lastModifier
-
latestContent:
latestContent
-
links: array
Links
Title:
LinksRead Only:trueREST API canonical and/or collection links for this Singular Resource -
locale(required):
locale
-
owner:
owner
-
pending: boolean
Title:
PendingRead Only:trueDefault Value:falseIndicates whether this article version is scheduled to go live in the future. The value is false for most article versions. -
publishDate: string
(date)
Title:
Publish DateRead Only:trueThe date and time when this article version was published. -
published: boolean
Title:
PublishedRead Only:trueDefault Value:falseIndicates whether this article version is published. Default value is false for all versions other than the published version, if there is one. -
publishedContent:
publishedContent
-
publishedVersion: string
Title:
Published VersionRead Only:trueMaximum Length:50If this article has a published version in the requested locale, this fields will contain the version number of the published article version. -
rating:
rating
-
ratingsAggregate:
ratingsAggregate
-
recordId: string
Title:
Record IDRead Only:trueThe unique identifier of the article. This ID is the same in all versions in all locales of the article and is recommended for programmatic use. -
reviewInformation:
reviewInformation
-
schemaAttributes: array
Schema Attributes
Title:
Schema AttributesRead Only:trueReturns information about the schema of an article. -
title: string
Title:
TitleRead Only:trueMaximum Length:4000The title of the document. -
version: string
Title:
VersionRead Only:trueMaximum Length:50The version of the article. -
versionId: string
Title:
Version IDRead Only:trueMaximum Length:64The unique identifier of the specific version of an article in a specific locale. You cannot use this field in queries made using q query parameter. -
versionState: string
Title:
Version StateRead Only:trueThe state of a version, possible values are SCHEDULED, LIVE, EXPIRED, DRAFT. -
workflowStep:
workflowStep
arrayAll Translationstrue-
Array of:
object ContentDataBO
Documentation for BO mode: ContentDataBO
arrayAll Versionstrue-
Array of:
object ContentKeyBO
Documentation for BO mode: ContentKeyBO
The article status.
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+in+('DRAFT', 'WORK_IN_PROGRESS')http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT' and contentState eq 'LATEST'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+eq+'IM_NULL_ARTICLE_STATUS'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+in+('IM_NULL_ARTICLE_STATUS', 'DRAFT')
The service response matches any Content object (PUBLISHED by default) with article status specified in the request if you pass the articleStatus.refKey parameter.
Example URIs for the articleStatus parameter are as follows:
OR
The following example URIs returns Content objects whose contentState is LATEST:
The following example URI returns Content objects with no article status assigned:
The following example URI returns Content objects with no article status assigned and Content objects with the Draft article status assigned:
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
-
object
ArticleStatusKeyBO
Documentation for BO mode: ArticleStatusKeyBO
-
Title:
Article StatusThe article status.
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+in+('DRAFT', 'WORK_IN_PROGRESS')http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT' and contentState eq 'LATEST'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+eq+'IM_NULL_ARTICLE_STATUS'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+in+('IM_NULL_ARTICLE_STATUS', 'DRAFT')
The service response matches any Content object (PUBLISHED by default) with article status specified in the request if you pass the
articleStatus.refKeyparameter.Example URIs for the articleStatus parameter are as follows:
OR
The following example URIs returns Content objects whose contentState is LATEST:
The following example URI returns Content objects with no article status assigned:
The following example URI returns Content objects with no article status assigned and Content objects with the Draft article status assigned:
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
-
object
ContentAutosaveKeyBO
-
Title:
AutosaveRead Only:trueautosave record.
arrayAutosave Listtrue-
object
LocaleKeyBO
Documentation for BO mode: LocaleKeyBO:
Localized Name of the Locale is currently NOT provided (i.e. The word Japanese is always in Japanese and never localized in say Arabic.)
-
Title:
Based LocaleThe source locale used to create the localized version of the document. This field is seen only if the content has a localized version.
The user or author who performed the last content checkout. The following are the subfields that can be used with checkedOutBy query parameter:
- checkedOutBy.recordId : The unique identifier of the checkedOutBy object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=checkedOutBy.recordId eq '{id}' - checkedOutBy.email : User's email.
- checkedOutBy.firstName : User's firstName.
- checkedOutBy.lastName : User's lastName.
- checkedOutBy.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
Checked Out ByRead Only:trueThe user or author who performed the last content checkout. The following are the subfields that can be used with checkedOutBy query parameter:
- checkedOutBy.recordId : The unique identifier of the checkedOutBy object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=checkedOutBy.recordId eq '{id}' - checkedOutBy.email : User's email.
- checkedOutBy.firstName : User's firstName.
- checkedOutBy.lastName : User's lastName.
- checkedOutBy.login : User's login.
- checkedOutBy.recordId : The unique identifier of the checkedOutBy object. For example, to request an article with unique id, submit a call using the URI:
The channel to which the content is categorized and saved. The following are the subfields that can be used with contentType query parameter:
- contentType.recordId : The unique identifier of the ContentType object.
- contentType.referenceKey : The reference key for the ContentType object. ContentType objects support multiple languages. This field can be used to identify the associated objects for all languages. For Example to request articles for content type FAQ, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=contentType.referenceKey eq 'FAQ' - contentType.allowRecommendations : The flag indicates whether the content type allows end users to create recommendations for its contents. This also indicates whether you can associate the recommended content with a content type.
-
object
ContentTypeKeyBO
Documentation for BO mode: ContentTypeKeyBO
-
Title:
Content TypeThe channel to which the content is categorized and saved. The following are the subfields that can be used with contentType query parameter:
- contentType.recordId : The unique identifier of the ContentType object.
- contentType.referenceKey : The reference key for the ContentType object. ContentType objects support multiple languages. This field can be used to identify the associated objects for all languages. For Example to request articles for content type FAQ, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=contentType.referenceKey eq 'FAQ' - contentType.allowRecommendations : The flag indicates whether the content type allows end users to create recommendations for its contents. This also indicates whether you can associate the recommended content with a content type.
The user who originally authored or created the document. The following are the subfields that can be used with creator query parameter:
- creator.recordId : The unique identifier of the creator object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=creator.recordId eq '{id}' - creator.email : User's email.
- creator.firstName : User's firstName.
- creator.lastName : User's lastName.
- creator.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
CreatorRead Only:trueThe user who originally authored or created the document. The following are the subfields that can be used with creator query parameter:
- creator.recordId : The unique identifier of the creator object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=creator.recordId eq '{id}' - creator.email : User's email.
- creator.firstName : User's firstName.
- creator.lastName : User's lastName.
- creator.login : User's login.
- creator.recordId : The unique identifier of the creator object. For example, to request an article with unique id, submit a call using the URI:
objectContent External Associationstrue-
object ContentExternalAssociationBO
Documentation for ContentExternalAssociationBO
The user or author who performed the last content modification. The following are the subfields that can be used with lastModifier query parameter:
- lastModifier.recordId : The unique identifier of the lastModifier object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=lastModifier.recordId eq '{id}' - lastModifier.email : User's email.
- lastModifier.firstName : User's firstName.
- lastModifier.lastName : User's lastName.
- lastModifier.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
Last ModifierRead Only:trueThe user or author who performed the last content modification. The following are the subfields that can be used with lastModifier query parameter:
- lastModifier.recordId : The unique identifier of the lastModifier object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=lastModifier.recordId eq '{id}' - lastModifier.email : User's email.
- lastModifier.firstName : User's firstName.
- lastModifier.lastName : User's lastName.
- lastModifier.login : User's login.
- lastModifier.recordId : The unique identifier of the lastModifier object. For example, to request an article with unique id, submit a call using the URI:
-
object
ContentKeyBO
Documentation for BO mode: ContentKeyBO
-
Title:
Latest ContentRead Only:trueLatest BO for this document.
arrayLinkstrueThe locale of the version of the document. The locale code represents the language and country associated with the Locale object. The following subfield can be used with locale query parameter:
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=locale.recordId eq 'es_ES'
-
object
LocaleKeyBO
Documentation for BO mode: LocaleKeyBO:
Localized Name of the Locale is currently NOT provided (i.e. The word Japanese is always in Japanese and never localized in say Arabic.)
-
Title:
LocaleThe locale of the version of the document. The locale code represents the language and country associated with the Locale object. The following subfield can be used with locale query parameter:
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=locale.recordId eq 'es_ES'
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
The user or author who owns or is responsible for the document. The following are the subfields that can be used with owner query parameter:
- owner.recordId : The unique identifier of the owner object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=owner.recordId eq '{id}' - owner.email : User's email.
- owner.firstName : User's firstName.
- owner.lastName : User's lastName.
- owner.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
OwnerRead Only:trueThe user or author who owns or is responsible for the document. The following are the subfields that can be used with owner query parameter:
- owner.recordId : The unique identifier of the owner object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=owner.recordId eq '{id}' - owner.email : User's email.
- owner.firstName : User's firstName.
- owner.lastName : User's lastName.
- owner.login : User's login.
- owner.recordId : The unique identifier of the owner object. For example, to request an article with unique id, submit a call using the URI:
-
object
ContentKeyBO
Documentation for BO mode: ContentKeyBO
-
Title:
Published ContentRead Only:truePublished BO for this document.
- CUSTOM(0)
- YES(1)
- YES_NO(2)
- THREE_STARS(3)
- FIVE_STARS(4)
-
object
DataFormBO
Documentation for BO mode: DataFormBO
-
Title:
RatingRead Only:trueDetermined whether it is a 5 star or Y/N type of rating.- CUSTOM(0)
- YES(1)
- YES_NO(2)
- THREE_STARS(3)
- FIVE_STARS(4)
-
object
AggregateFormResultsBO
Documentation for BO mode: AggregateFormResultsBO
-
Title:
Ratings AggregateRead Only:trueThe aggregate form results. This includes the average rating, the total responses, and the specific rating values for this article.
-
object
ContentReviewInformationBO
Content Review Information BO
-
Title:
Review InformationRead Only:trueReview information added after document marked as reviewed.
arraySchema Attributestrue-
Array of:
object SchemaAttributeBO
Documentation for BO mode: SchemaAttributeBO
-
object
WorkflowStepDataBO
Documentation for BO mode: WorkflowStepDataBO
-
Title:
Workflow StepRead Only:trueThe step of the workflow in which the document version currently exist.
object-
allTranslations: array
All Translations
Title:
All TranslationsRead Only:trueContains a collection of translations available of an article, if there are any. -
allVersions: array
All Versions
Title:
All VersionsRead Only:trueContains a collection of all versions of an article. -
answerId: integer
(int64)
Title:
Answer IDRead Only:trueThe unique identifier of an article in a locale. -
articleStatus:
articleStatus
-
autoCheckIn: boolean
Title:
Auto Check InRead Only:trueDefault Value:falseIndicates whether the article needs to be automatically checked in after saving it. -
autosave:
autosave
-
autosaveList: array
Autosave List
Title:
Autosave ListRead Only:trueContains a collection of autosaves that exist for an article, if there are any. -
dateModified: string
(date)
Title:
Date ModifiedRead Only:trueThe date and time when this article was last modified. -
displayEndDate: string
(date)
Title:
Display End DateThe date and time when the article will stop being available to display to end-users. -
displayReviewDate: string
(date)
Title:
Display Review DateThe date and time when the article requires a review by an author capable of performing the review. -
displayStartDate: string
(date)
Title:
Display Start DateThe date and time when the article will be available to display to end-users.. -
documentId: string
Title:
Document IDRead Only:trueThe unique identifier of an article most usable for humans. -
externalAssociations: object
Content External Associations
Title:
Content External AssociationsRead Only:trueAdditional Properties Allowed: ContentExternalAssociationBOThis field will return external associations of content such as a reference to an SR this article was created from. -
latestContent:
latestContent
-
links: array
Links
Title:
LinksRead Only:trueREST API canonical and/or collection links for this Singular Resource -
locale(required):
locale
-
publishedContent:
publishedContent
-
rating:
rating
-
ratingsAggregate:
ratingsAggregate
-
recordId: string
Title:
Record IDRead Only:trueThe unique identifier of the article. This ID is the same in all versions in all locales of the article and is recommended for programmatic use. -
reviewInformation:
reviewInformation
-
schemaAttributes: array
Schema Attributes
Title:
Schema AttributesRead Only:trueReturns information about the schema of an article. -
title: string
Title:
TitleRead Only:trueMaximum Length:4000The title of the document. -
version: string
Title:
VersionRead Only:trueMaximum Length:50The version of the article. -
versionId: string
Title:
Version IDRead Only:trueMaximum Length:64The unique identifier of the specific version of an article in a specific locale. You cannot use this field in queries made using q query parameter. -
versionState: string
Title:
Version StateRead Only:trueThe state of a version, possible values are SCHEDULED, LIVE, EXPIRED, DRAFT.
arrayAll Translationstrue-
Array of:
object ContentDataBO
Documentation for BO mode: ContentDataBO
arrayAll Versionstrue-
Array of:
object ContentKeyBO
Documentation for BO mode: ContentKeyBO
The article status.
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+in+('DRAFT', 'WORK_IN_PROGRESS')http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT' and contentState eq 'LATEST'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+eq+'IM_NULL_ARTICLE_STATUS'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+in+('IM_NULL_ARTICLE_STATUS', 'DRAFT')
The service response matches any Content object (PUBLISHED by default) with article status specified in the request if you pass the articleStatus.refKey parameter.
Example URIs for the articleStatus parameter are as follows:
OR
The following example URIs returns Content objects whose contentState is LATEST:
The following example URI returns Content objects with no article status assigned:
The following example URI returns Content objects with no article status assigned and Content objects with the Draft article status assigned:
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
-
object
ArticleStatusKeyBO
Documentation for BO mode: ArticleStatusKeyBO
-
Title:
Article StatusThe article status.
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+in+('DRAFT', 'WORK_IN_PROGRESS')http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT' and contentState eq 'LATEST'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+eq+'IM_NULL_ARTICLE_STATUS'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+in+('IM_NULL_ARTICLE_STATUS', 'DRAFT')
The service response matches any Content object (PUBLISHED by default) with article status specified in the request if you pass the
articleStatus.refKeyparameter.Example URIs for the articleStatus parameter are as follows:
OR
The following example URIs returns Content objects whose contentState is LATEST:
The following example URI returns Content objects with no article status assigned:
The following example URI returns Content objects with no article status assigned and Content objects with the Draft article status assigned:
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
-
object
ContentAutosaveKeyBO
-
Title:
AutosaveRead Only:trueautosave record.
arrayAutosave ListtrueobjectContent External Associationstrue-
object ContentExternalAssociationBO
Documentation for ContentExternalAssociationBO
-
object
ContentKeyBO
Documentation for BO mode: ContentKeyBO
-
Title:
Latest ContentRead Only:trueLatest BO for this document.
arrayLinkstrueThe locale of the version of the document. The locale code represents the language and country associated with the Locale object. The following subfield can be used with locale query parameter:
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=locale.recordId eq 'es_ES'
-
object
LocaleKeyBO
Documentation for BO mode: LocaleKeyBO:
Localized Name of the Locale is currently NOT provided (i.e. The word Japanese is always in Japanese and never localized in say Arabic.)
-
Title:
LocaleThe locale of the version of the document. The locale code represents the language and country associated with the Locale object. The following subfield can be used with locale query parameter:
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=locale.recordId eq 'es_ES'
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
-
object
ContentKeyBO
Documentation for BO mode: ContentKeyBO
-
Title:
Published ContentRead Only:truePublished BO for this document.
- CUSTOM(0)
- YES(1)
- YES_NO(2)
- THREE_STARS(3)
- FIVE_STARS(4)
-
object
DataFormBO
Documentation for BO mode: DataFormBO
-
Title:
RatingRead Only:trueDetermined whether it is a 5 star or Y/N type of rating.- CUSTOM(0)
- YES(1)
- YES_NO(2)
- THREE_STARS(3)
- FIVE_STARS(4)
-
object
AggregateFormResultsBO
Documentation for BO mode: AggregateFormResultsBO
-
Title:
Ratings AggregateRead Only:trueThe aggregate form results. This includes the average rating, the total responses, and the specific rating values for this article.
-
object
ContentReviewInformationBO
Content Review Information BO
-
Title:
Review InformationRead Only:trueReview information added after document marked as reviewed.
arraySchema Attributestrue-
Array of:
object SchemaAttributeBO
Documentation for BO mode: SchemaAttributeBO
object-
links: array
Links
Title:
LinksRead Only:trueThe collection links related to this resource -
name: string
Title:
NameRead Only:trueMinimum Length:1Maximum Length:255The localized name of the ArticleStatus object. The name field can only be used for sorting. -
recordId: string
Title:
Record IdThe unique identifier of the ArticleStatus object. -
referenceKey: string
Title:
Reference KeyMaximum Length:255The reference key for the ArticleStatus object. ArticleStatus objects support multiple languages. This field can be used to identify the associated objects for all languages.
arrayLinkstrueobject-
autosaveType(required):
autosaveType
-
dateAdded: string
(date)
Title:
Date AddedRead Only:trueThe date and time when this autosave was created. -
dateModified: string
(date)
Title:
Date ModifiedRead Only:trueThe date and time this autosave was last modified. -
documentId: string
Title:
Document IdRead Only:trueThe unique identifier of a document that indicates the content type in which the content is saved. -
locale: object
LocaleKeyBO
Documentation for BO mode: LocaleKeyBO:
Localized Name of the Locale is currently NOT provided (i.e. The word Japanese is always in Japanese and never localized in say Arabic.)
-
recordId: string
-
title: string
Maximum Length:
4000
-
string
Allowed Values:
[ "ALL", "CREATED", "EDITED", "TRANSLATED" ] -
objectLocalized Name of the Locale is currently NOT provided (i.e. The word Japanese is always in Japanese and never localized in say Arabic.)
-
links: array
Links
Title:
LinksRead Only:trueREST API canonical and/or collection links for this Singular Resource -
localeDesc: string
Title:
Locale DescRead Only:trueMaximum Length:100The description about the language and country that the Locale object represents. -
recordId: string
Title:
Record IdThe unique identifier of the Locale object.
arrayLinkstrueobject-
alternateId: string
Title:
Alternate IdThe alternate identifier of the external association -
alternateIdType: string
Title:
Alternate Id TypeThe alternate type of the external assocation -
objectId(required): string
Title:
Object IdMinimum Length:1Maximum Length:50The unique identifier of the external association. -
properties: object
Properties
Title:
PropertiesAdditional Properties Allowed: additionalPropertiesThe properties of the external association -
type(required): string
Title:
Object TypeMinimum Length:1Maximum Length:100The type of the external association
objectPropertiesobject-
dateAdded(required): string
(date)
Title:
Date AddedRead Only:trueThe date and time when this DataForm object was created. -
dateModified(required): string
(date)
Title:
Date ModifiedRead Only:trueThe date and time when this DataForm object was last modified. -
displayEndDate: string
(date)
Title:
Display End DateThe date when the service stops the display of the data form to the end users -
displayStartDate: string
(date)
Title:
Display Start DateThe date when the data form will be available to display to end-users -
emailContent: boolean
Title:
Email ContentThe emailContent field of the DataForm object -
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
name: string
Title:
NameMaximum Length:255The name of the data form. The name field can only be used for sorting. -
questions: array
Questions
Title:
QuestionsTo Many Relationship to Question -
ratingType: integer
(int32)
Title:
Rating TypeDetermined whether it is a 5 star or Y/N type of rating- CUSTOM(0)
- YES(1)
- YES_NO(2)
- THREE_STARS(3)
- FIVE_STARS(4)
-
recordId(required): string
Title:
Record IdRead Only:trueThe unique identifier of the DataForm object -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:255The reference key for the DataForm object -
user:
user
-
views: array
Views
Title:
ViewsTo Many Relationship to View
arrayLinksarrayQuestions-
Array of:
object DataFormQuestionBO
Documentation for BO mode: QuestionBO
arrayViews-
Array of:
object ViewKeyBO
Documentation for BO mode: ViewKeyBO
object-
answers: array
Answers
Title:
AnswersTo Many Relationship to Answer -
dataForm:
dataForm
-
dateAdded(required): string
(date)
Title:
Date AddedRead Only:trueThe date and time the DataFormQuestion object was created -
dateModified(required): string
(date)
Title:
Date ModifiedRead Only:trueThe date and time the DataFormQuestion object was last modified -
isMasterIdentifier: boolean
Title:
Is Master IdentifierThe isMasterIdentifier field of the DataFormQuestion object -
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
name(required): string
Title:
NameMinimum Length:1Maximum Length:255The localized name of the DataFormQuestion object -
recordId(required): string
Title:
Record IdRead Only:trueThe unique identifier of the DataFormQuestion object -
referenceKey: string
Title:
Reference KeyMaximum Length:255The reference key for the DataFormQuestion object -
required: boolean
Title:
RequiredThe flag that indicates whether or not this question is required -
sortOrder: integer
(int32)
Title:
Sort OrderThe sort order of this question -
specialTypeIndicator: integer
(int32)
Title:
Special Type IndicatorThe specialTypeIndicator field of the DataFormQuestion object
arrayAnswers-
Array of:
object DataFormAnswerBO
Documentation for BO mode: AnswerBO
-
object
DataFormKeyBO
Documentation for BO mode: DataFormKeyBO
-
Title:
Data FormRelationship to Rating
arrayLinksobject-
dataFormQuestion:
dataFormQuestion
-
dateAdded(required): string
(date)
Title:
Date AddedRead Only:trueThe date and time when this DataFormAnswer object was created. -
dateModified(required): string
(date)
Title:
Date ModifiedRead Only:trueThe date and time when this DataFormAnswer object was last modified. -
defaultAnswer: boolean
Title:
Default AnswerThe flag that indicates whether or not this answer is the default answer -
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
name(required): string
Title:
NameMinimum Length:1Maximum Length:255The localized name of the DataFormAnswer object -
numberValue: integer
(int32)
Title:
Number ValueThe numeric value of the answer -
recordId(required): string
Title:
Record IdRead Only:trueThe unique identifier of the DataFormAnswer object -
referenceKey: string
Title:
Reference KeyMaximum Length:255The reference key for the DataFormAnswer object -
sortOrder: integer
(int32)
Title:
Sort OrderThe sort order of the answer
-
object
DataFormQuestionKeyBO
Documentation for BO mode: QuestionKeyBO
-
Title:
Data Form QuestionRelationship to Question
arrayLinksobject-
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
recordId(required): string
Title:
Record IdRead Only:trueThe unique identifier of the DataFormQuestion object -
referenceKey: string
Title:
Reference KeyMaximum Length:255The reference key for the DataFormQuestion object
arrayLinksobject-
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
recordId(required): string
Title:
Record IdRead Only:trueThe unique identifier of the DataForm object -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:255The reference key for the DataForm object
arrayLinksobject-
canAssignTask: boolean
Title:
Can Assign tasksReturns whether this user can assign tasks to other users. -
contentTypePrivileges: array
Content Type Privileges
Title:
Content Type PrivilegesThis field will return list of all contenttype privileges user have -
email: string
Title:
EmailMaximum Length:100The user's e-mail address -
externalId: integer
(int64)
Title:
External IdRead Only:trueThe ExternalId is the Id of the corresponding User from an external system. It, along with ExternalType, can be used to bridge the gap between a User from this system and a User from an external system. -
functionalPrivileges: object
Functional Privileges of user
Title:
Functional Privileges of userAdditional Properties Allowed: additionalPropertiesThis field will return list of all fucntional privileges user have -
links: array
Links
Title:
LinksRead Only:trueREST API canonical and/or collection links for this Singular Resource -
login: string
Title:
LoginMaximum Length:100The user's login -
name: string
Title:
NameRead Only:trueMaximum Length:100User's full name -
recordId(required): integer
(int64)
Title:
Record IdRead Only:trueThe unique identifier of the user
arrayContent Type Privileges-
Array of:
object CompositeContentTypeBO
Composite of ContentTypeBO and its flattened relation. Keep in mind we can add more stuff down the line
objectFunctional Privileges of user arrayLinkstrueobject-
compositeWorkflowSteps(required): array
WorkflowSteps Composite BO
Title:
WorkflowSteps Composite BOWorkflowSteps mapped to this content type and user privileges on that -
contentTypeKeyBO(required):
contentTypeKeyBO
-
hasContentTypeAccess: boolean
Title:
Has Content Type AccessVerifies if ContentTypeBO privileges are valid for user -
listOfPrivilege(required): array
List Of Privilege
Title:
List Of PrivilegeList of Privileges for the ContentType
arrayWorkflowSteps Composite BO-
Array of:
object CompositeWorkflowStepBO
Composite of WorkflowStepBO with user privileges on this step.
-
object
ContentTypeKeyBO
Documentation for BO mode: ContentTypeKeyBO
-
Title:
Content Type Key BOContentBO object being created or updated
arrayList Of Privilegeobject-
listOfPrivilege(required): array
List Of Privilege
Title:
List Of PrivilegeList of Privileges for the WorkflowStep -
WorkflowStepKeyBO(required):
WorkflowStepKeyBO
arrayList Of Privilege-
object
WorkflowStepKeyBO
Documentation for BO mode: WorkflowStepKeyBO
-
Title:
WorkflowStep Key BOWorkflowStep object being fetched
object-
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
name: string
Title:
NameMaximum Length:255Localized name of the workflow step -
recordId(required): string
Title:
Record IdRead Only:trueGUID from the WORKFLOWSTEP table -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:100Non localized name of the workflow step -
workflowId(required): string
Title:
WorkflowRecord IdRead Only:trueGUID from the WORKFLOW table
arrayLinksobject-
description: string
Title:
DescriptionMaximum Length:255The description for the ContentType object. Content Types support multiple languages. This field identifies the object associated with the language specified by the user. -
links: array
Links
Title:
LinksRead Only:trueREST API canonical and/or collection links for this Singular Resource -
name(required): string
Title:
NameMinimum Length:1Maximum Length:255The name for the ContentType object. The name field can only be used for sorting. Content Types support multiple languages. This field identifies the object associated with the language specified by the user. -
recordId: string
Title:
Record IdRead Only:trueThe unique identifier of the ContentType object. -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:255The reference key for the ContentType object. ContentType objects support multiple languages. This field can be used to identify the associated objects for all languages. -
stripeCd(required): string
Title:
Stripe CdMaximum Length:30Lookup code that indicates the stripe code. -
usageCode: string
Title:
Usage CodeRead Only:trueMaximum Length:30Lookup code that indicates the product usage code. -
workflow:
workflow
arrayLinkstrue-
object
WorkflowKeyBO
-
Title:
WorkflowThe workflow definition that the author can use while content authoring in a content type.
object-
enabled: boolean
-
links: array
links
-
name: string
Maximum Length:
255 -
recordId: string
-
referenceKey: string
Minimum Length:
0Maximum Length:100 -
workflowVersion: integer
(int32)
object-
links: array
Links
Title:
LinksRead Only:trueREST API canonical and/or collection links for this Singular Resource -
name: string
Title:
NameMaximum Length:255Localized name of the view -
recordId(required): string
Title:
Record IdRead Only:trueGUID of the SITE table containing the view definition -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:255Non localized reference key for the view -
stripeCd: string
Title:
Stripe CDMaximum Length:30Stripe of a view
arrayLinkstrueobject-
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
questions: array
Questions
Title:
QuestionsTo Many Relationship to AggregateQuestionResult -
recordId(required): string
Title:
Record IdRead Only:trueThe unique record ID of the AggregateFormResults object. -
referenceKey: string
Title:
Reference KeyMaximum Length:255The reference key for the AggregateFormResults object. AggregateFormResults objects support multiple languages. This field can be used to identify the associated objects for all languages. -
totalResponses: integer
(int64)
Title:
Total ResponsesTotalResponses of the AggregateFormResults object
arrayLinksarrayQuestions-
Array of:
object AggregateQuestionResultBO
Documentation for BO mode: AggregateQuestionResultBO
object-
answers: array
Answers
Title:
AnswersTo Many Relationship to AggregateAnswerResult -
averageResponse: number
(double)
Title:
Average ResponseAverageResponse of the AggregateQuestionResult object -
name(required): string
Title:
NameMinimum Length:1Maximum Length:255Localized display name for the Question -
recordId(required): string
Title:
Record IdRead Only:trueThe unique record ID of the AggregateQuestionResult object. -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:255The reference key for the AggregateQuestionResult object. AggregateQuestionResult objects support multiple languages. This field can be used to identify the associated objects for all languages. -
totalResponses: integer
(int64)
Title:
Total ResponsesTotalResponses of the AggregateQuestionResult object
arrayAnswers-
Array of:
object AggregateAnswerResultBO
Documentation for BO mode: AggregateAnswerResultBO
object-
name(required): string
Title:
NameMinimum Length:1Maximum Length:255Localized display name for the Answer -
recordId(required): string
Title:
Record IdRead Only:trueThe unique record ID of the AggregateAnswerResult object. -
referenceKey: string
Title:
Reference KeyMaximum Length:255The reference key for the AggregateAnswerResult object. AggregateAnswerResult objects support multiple languages. This field can be used to identify the associated objects for all languages. -
totalResponses: integer
(int64)
Title:
Total ResponsesTotalResponses of the AggregateAnswerResult object
object-
lastUpdateDate: string
(date)
Title:
Last Update DateRead Only:trueThe date when the document was marked reviewed. -
lastUpdatedBy:
lastUpdatedBy
-
state:
state
-
string
Allowed Values:
[ "REVIEWED" ] -
Title:
StateRead Only:truereview state for document.
object-
allowMultipleNodes: boolean
Title:
Allow Multiple NodesFlag indicating if multiple nodes are allowed of this type@since 8.3 -
allowPreselectedUserGroupChange: boolean
Title:
Allow Preselected User Group ChangeEnable editors to modify preselected user group restrictions@since 8.3 -
children: array
Children
Title:
ChildrenList of child nodes of the current element -
counter: integer
(int32)
Title:
CounterThis attribute contains the current value of the ContentType DOC ID counter. This value should not be changed after content is added to the ContentType -
counterPrefix: string
Title:
Counter PrefixMaximum Length:50This attribute contains the prefix that is appended to the front of the DOC ID counter -
dateAdded: string
(date)
Title:
Date AddedRead Only:trueThe date and time when this SchemaAttribute definition was first created -
dateModified: string
(date)
Title:
Date ModifiedRead Only:trueThe date and time when this SchemaAttribute definition was last modified -
description: string
Title:
DescriptionMaximum Length:1000Localized help text for the attribute. This text is displayed in the authoring view -
enableAttributeLevelSearch: boolean
Title:
Enable Attribute Level SearchFlag indicating whether this field should be configured for attribute level searching - i.e. where TITLE='xyz'. This fieldwas previously called searchable@since 8.3 -
enableFullTextSearch: boolean
Title:
Enable Full Text SearchFlag indicating whether this field should be included in the full text index. This field was previouslycalled indexable@since 8.3 -
includeInMasterIdentifier: boolean
Title:
Include In Master IdentifierFlag indicating whether this field should be appended to the master identifier of the document -
isNode: boolean
Title:
Is NodeFlag indicating if this element is a node@since 8.3 -
isRequired: boolean
Title:
Is RequiredMake attribute a required field@since 8.3 -
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
localizedAttributes: array
Localized Attributes
Title:
Localized AttributesList of LocalizedAttributes of this SchemaAttribute name and description in various Locales -
name(required): string
Title:
NameMinimum Length:1Maximum Length:255Localized name of the attribute. This need NOT be unique within the Schema. -
readOnly: boolean
Title:
Read OnlyFlag indicating whether this field is editable -
recordId: string
Title:
Record IdRead Only:trueUnique identifier for the SchemaAttribute object -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:100Non localized name of the attribute.SchemaAttribute's referenceKey need NOT be unique within its Schema.But its xpath will be unique within its Schema. -
requireWorkflowApproval: boolean
Title:
Require Workflow ApprovalAttribute requires workflow approval if workflow is enabled -
schemaAttributeUserGroupList: array
Schema Attribute User Group List
Title:
Schema Attribute User Group ListList of user groups that can be used to secure this attribute. This should be a subset of the list of user groups assigned to the ContentType -
schemaAttrType:
schemaAttrType
-
securedFileResource: boolean
Title:
Secured File ResourceFlag indicating if this attribute (file types only) should be marked as secure - i.e. stored in the ~secure folder near the content XML file -
secureWithUserGroups: boolean
Title:
Secure With User GroupsRestrict attribute to selected user groups -
securityRegex: string
Title:
Security RegexMaximum Length:100The regular expression used to validate the field against security attacks. -
sortOrder: integer
(int32)
Title:
Sort OrderDisplay order of the schema attributes within the edit form -
textHeight: string
Title:
Text HeightMaximum Length:10Specifies the text height for text areas and rich text fields -
textWidth: string
Title:
Text WidthMaximum Length:10Specifies the max length for text fields -
userGroupSelectionRequired: boolean
Title:
User Group Selection RequiredUser groups are required for attribute -
wysiwygType:
wysiwygType
-
xpath: string
Title:
XpathMaximum Length:2000The XPATH of this attribute within the schema. This is unique within the Schema.
arrayChildren-
Array of:
object SchemaAttributeBO
Documentation for BO mode: SchemaAttributeBO
arrayLinksarrayLocalized AttributesarraySchema Attribute User Group List-
string
Allowed Values:
[ "BOOLEAN", "COUNTER", "DATE", "DATETIME", "FILE", "FLOAT", "INTEGER", "LIST", "TEXT_AREA", "TEXT_FIELD", "TIME", "WYSIWYG_EDIT" ] -
Title:
Schema Attr TypeEnumerated type representing the type of attribute - i.e. text field, rich text area
-
string
Allowed Values:
[ "BASIC", "FULL", "MEDIUM" ] -
Title:
Wysiwyg TypeType of WYSIWYG rich text field - i.e. FULL, BASIC, MEDIUM@since 8.3
object-
description: string
Title:
DescriptionMaximum Length:1000Localized description in the above Locale -
localeId(required): string
Title:
Locale IdRead Only:trueRecordId of the Locale - generally this is the localeCode (like en_US) and NOT a real GUID. -
name(required): string
Title:
NameMinimum Length:1Maximum Length:255Localized Name in the above Locale
object-
defaultValue: boolean
-
recordId: string
-
userGroup: object
UserGroupKeyBO
Documentation for BO mode: UserGroupKeyBO
object-
links: array
Links
Title:
LinksRead Only:trueThe collection links related to this resource -
name: string
Title:
NameRead Only:trueMaximum Length:255The localized name of the user group. The name field can only be used for sorting. -
recordId: string
Title:
Record IdThe unique identifier from the TAG table that represent a userGroups resource -
referenceKey: string
Title:
Reference KeyMaximum Length:255The non localized name of the user group -
stripeCd: string
Title:
Stripe CDRead Only:trueMaximum Length:30Stripe for UserGroup
arrayLinkstrueobject-
allowDocumentEditing: boolean
Title:
Allow Document EditingFlag indicating whether this step allows document editing -
dateAdded(required): string
(date)
Title:
Date AddedRead Only:trueThe date and time when this work flow step was added. -
dateModified(required): string
(date)
Title:
Date ModifiedRead Only:trueThe date and time when this work flow step was last modified. -
defaultStepDurationInMinutes: integer
(int32)
Title:
Default Workflow Step Due date in minutesTime in minutes that the workflow step task will stay in queue before being consdiered overdue -
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
name: string
Title:
NameMaximum Length:255Localized name of the workflow step -
onlyAssigneeCanAppove: boolean
Title:
Can only assignee approve stepFlag indicating whether this step can only be approved by workflow step task assignee -
recordId(required): string
Title:
Record IdRead Only:trueGUID from the WORKFLOWSTEP table -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:100Non localized name of the workflow step -
sortOrder: integer
(int32)
Title:
Sort OrderThe order of the workflow steps within the workflow -
workflowId(required): string
Title:
WorkflowRecord IdRead Only:trueGUID from the WORKFLOW table
arrayLinksobject-
categoryId(required): integer
(int64)
Title:
Category IdThe unique identifier of the category.
object-
inventoryItemId: integer
(int64)
Title:
Inventory Item IdThe unique identifier of the product. -
organizationId: integer
(int64)
Title:
Organization IdThe inventory organization id of the specific category. -
productGroupId: integer
(int64)
Title:
Product Group IdThe unique identifier of the product group.
object-
externalAssociations: object
Content External Associations
Title:
Content External AssociationsRead Only:trueAdditional Properties Allowed: ContentExternalAssociationBOThis field will return external associations of content. -
operation: string
Title:
OperationThe action this metadata is providing context for. -
sourceDocId: string
Title:
Source Doc IdRead Only:truedocId of the article being copied. -
sourceLocaleId: string
Title:
Source Locale IdRead Only:trueThe locale of the article being copied or reverted to. -
sourceVersion: string
Title:
Source VersionRead Only:trueThe version of the article being copied or reverted to. -
sourceVersionId: string
Title:
Source Version IdThe versionId of the acticle being copied.
objectContent External Associationstrue-
object ContentExternalAssociationBO
Documentation for ContentExternalAssociationBO
object-
allTranslations: array
All Translations
Title:
All TranslationsRead Only:trueContains a collection of translations available of an article, if there are any. -
allVersions: array
All Versions
Title:
All VersionsRead Only:trueContains a collection of all versions of an article. -
answerId: integer
(int64)
Title:
Answer IDRead Only:trueThe unique identifier of an article in a locale. -
articleStatus:
articleStatus
-
autoCheckIn: boolean
Title:
Auto Check InRead Only:trueDefault Value:falseIndicates whether the article needs to be automatically checked in after saving it. -
autosave:
autosave
-
autosaveList: array
Autosave List
Title:
Autosave ListRead Only:trueContains a collection of autosaves that exist for an article, if there are any. -
basedLocale:
basedLocale
-
basedOnVersion: string
Title:
Based On VersionRead Only:trueMaximum Length:50If this article version is a localization, this field may contain the version of the article the localization was created from. -
categories: array
Categories
Title:
CategoriesThe list of categories associated with the article. -
checkedOut: boolean
Title:
Checked OutRead Only:trueDefault Value:falseThe date and time when an author has checked out or locked the document for editing. -
checkedOutBy:
checkedOutBy
-
contentBody(required): object
Content Body
Title:
Content BodyContents of the article. -
contentType(required):
contentType
-
createDate: string
(date)
Title:
Create DateRead Only:trueThe date and time when this article was originally created. -
creator:
creator
-
dateAdded: string
(date)
Title:
Date AddedRead Only:trueThe date and time when this article version was created. -
dateModified: string
(date)
Title:
Date ModifiedRead Only:trueThe date and time when this article was last modified. -
displayEndDate: string
(date)
Title:
Display End DateThe date and time when the article will stop being available to display to end-users. -
displayReviewDate: string
(date)
Title:
Display Review DateThe date and time when the article requires a review by an author capable of performing the review. -
displayStartDate: string
(date)
Title:
Display Start DateThe date and time when the article will be available to display to end-users.. -
documentId: string
Title:
Document IDRead Only:trueThe unique identifier of an article most usable for humans. -
externalAssociations: object
Content External Associations
Title:
Content External AssociationsRead Only:trueAdditional Properties Allowed: ContentExternalAssociationBOThis field will return external associations of content such as a reference to an SR this article was created from. -
isForEdit: boolean
Title:
Is For EditRead Only:trueDefault Value:falseIndicates whether the purpose of the request was to get an editable version of an article. Default value is false. -
lastModifiedDate: string
(date)
Title:
Last Modified DateRead Only:trueThe date and time when this article was last modified. -
lastModifier:
lastModifier
-
latestContent:
latestContent
-
links: array
Links
Title:
LinksRead Only:trueREST API canonical and/or collection links for this Singular Resource -
locale(required):
locale
-
owner:
owner
-
pending: boolean
Title:
PendingRead Only:trueDefault Value:falseIndicates whether this article version is scheduled to go live in the future. The value is false for most article versions. -
products: array
Products
Title:
ProductsThe list of products associated with the article. -
publishDate: string
(date)
Title:
Publish DateRead Only:trueThe date and time when this article version was published. -
published: boolean
Title:
PublishedRead Only:trueDefault Value:falseIndicates whether this article version is published. Default value is false for all versions other than the published version, if there is one. -
publishedContent:
publishedContent
-
publishedVersion: string
Title:
Published VersionRead Only:trueMaximum Length:50If this article has a published version in the requested locale, this fields will contain the version number of the published article version. -
rating:
rating
-
ratingsAggregate:
ratingsAggregate
-
reasonForEdit: string
Title:
Reason For EditMaximum Length:2000Reasons for editing or creating an article version. -
recordId: string
Title:
Record IDRead Only:trueThe unique identifier of the article. This ID is the same in all versions in all locales of the article and is recommended for programmatic use. -
reviewInformation:
reviewInformation
-
schemaAttributes: array
Schema Attributes
Title:
Schema AttributesRead Only:trueReturns information about the schema of an article. -
sourceMetadata:
sourceMetadata
-
title: string
Title:
TitleRead Only:trueMaximum Length:4000The title of the document. -
userGroups: array
User Groups
Title:
User GroupsThe user groups assigned to the content. Only the members of the assigned user group will have access to the content. Default value is Everyone. -
version: string
Title:
VersionRead Only:trueMaximum Length:50The version of the article. -
versionId: string
Title:
Version IDRead Only:trueMaximum Length:64The unique identifier of the specific version of an article in a specific locale. You cannot use this field in queries made using q query parameter. -
versionState: string
Title:
Version StateRead Only:trueThe state of a version, possible values are SCHEDULED, LIVE, EXPIRED, DRAFT. -
views: array
Views
Title:
ViewsRead Only:trueThe views assigned to the content. The user who has the view assigned to the content or the content type in which the content is saved can only access the content. -
workflowStep:
workflowStep
arrayAll Translationstrue-
Array of:
object ContentDataBO
Documentation for BO mode: ContentDataBO
arrayAll Versionstrue-
Array of:
object ContentKeyBO
Documentation for BO mode: ContentKeyBO
The article status.
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+in+('DRAFT', 'WORK_IN_PROGRESS')http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT' and contentState eq 'LATEST'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+eq+'IM_NULL_ARTICLE_STATUS'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+in+('IM_NULL_ARTICLE_STATUS', 'DRAFT')
The service response matches any Content object (PUBLISHED by default) with article status specified in the request if you pass the articleStatus.refKey parameter.
Example URIs for the articleStatus parameter are as follows:
OR
The following example URIs returns Content objects whose contentState is LATEST:
The following example URI returns Content objects with no article status assigned:
The following example URI returns Content objects with no article status assigned and Content objects with the Draft article status assigned:
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
-
object
ArticleStatusKeyBO
Documentation for BO mode: ArticleStatusKeyBO
-
Title:
Article StatusThe article status.
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+in+('DRAFT', 'WORK_IN_PROGRESS')http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT' and contentState eq 'LATEST'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+eq+'IM_NULL_ARTICLE_STATUS'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+in+('IM_NULL_ARTICLE_STATUS', 'DRAFT')
The service response matches any Content object (PUBLISHED by default) with article status specified in the request if you pass the
articleStatus.refKeyparameter.Example URIs for the articleStatus parameter are as follows:
OR
The following example URIs returns Content objects whose contentState is LATEST:
The following example URI returns Content objects with no article status assigned:
The following example URI returns Content objects with no article status assigned and Content objects with the Draft article status assigned:
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
-
object
ContentAutosaveKeyBO
-
Title:
AutosaveRead Only:trueautosave record.
arrayAutosave Listtrue-
object
LocaleKeyBO
Documentation for BO mode: LocaleKeyBO:
Localized Name of the Locale is currently NOT provided (i.e. The word Japanese is always in Japanese and never localized in say Arabic.)
-
Title:
Based LocaleThe source locale used to create the localized version of the document. This field is seen only if the content has a localized version.
arrayCategories-
Array of:
object CategoryItemKeyBO
Documentation for BO mode: CategoryItemKeyBO
The user or author who performed the last content checkout. The following are the subfields that can be used with checkedOutBy query parameter:
- checkedOutBy.recordId : The unique identifier of the checkedOutBy object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=checkedOutBy.recordId eq '{id}' - checkedOutBy.email : User's email.
- checkedOutBy.firstName : User's firstName.
- checkedOutBy.lastName : User's lastName.
- checkedOutBy.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
Checked Out ByRead Only:trueThe user or author who performed the last content checkout. The following are the subfields that can be used with checkedOutBy query parameter:
- checkedOutBy.recordId : The unique identifier of the checkedOutBy object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=checkedOutBy.recordId eq '{id}' - checkedOutBy.email : User's email.
- checkedOutBy.firstName : User's firstName.
- checkedOutBy.lastName : User's lastName.
- checkedOutBy.login : User's login.
- checkedOutBy.recordId : The unique identifier of the checkedOutBy object. For example, to request an article with unique id, submit a call using the URI:
objectContent BodyThe channel to which the content is categorized and saved. The following are the subfields that can be used with contentType query parameter:
- contentType.recordId : The unique identifier of the ContentType object.
- contentType.referenceKey : The reference key for the ContentType object. ContentType objects support multiple languages. This field can be used to identify the associated objects for all languages. For Example to request articles for content type FAQ, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=contentType.referenceKey eq 'FAQ' - contentType.allowRecommendations : The flag indicates whether the content type allows end users to create recommendations for its contents. This also indicates whether you can associate the recommended content with a content type.
-
object
ContentTypeKeyBO
Documentation for BO mode: ContentTypeKeyBO
-
Title:
Content TypeThe channel to which the content is categorized and saved. The following are the subfields that can be used with contentType query parameter:
- contentType.recordId : The unique identifier of the ContentType object.
- contentType.referenceKey : The reference key for the ContentType object. ContentType objects support multiple languages. This field can be used to identify the associated objects for all languages. For Example to request articles for content type FAQ, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=contentType.referenceKey eq 'FAQ' - contentType.allowRecommendations : The flag indicates whether the content type allows end users to create recommendations for its contents. This also indicates whether you can associate the recommended content with a content type.
The user who originally authored or created the document. The following are the subfields that can be used with creator query parameter:
- creator.recordId : The unique identifier of the creator object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=creator.recordId eq '{id}' - creator.email : User's email.
- creator.firstName : User's firstName.
- creator.lastName : User's lastName.
- creator.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
CreatorRead Only:trueThe user who originally authored or created the document. The following are the subfields that can be used with creator query parameter:
- creator.recordId : The unique identifier of the creator object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=creator.recordId eq '{id}' - creator.email : User's email.
- creator.firstName : User's firstName.
- creator.lastName : User's lastName.
- creator.login : User's login.
- creator.recordId : The unique identifier of the creator object. For example, to request an article with unique id, submit a call using the URI:
objectContent External Associationstrue-
object ContentExternalAssociationBO
Documentation for ContentExternalAssociationBO
The user or author who performed the last content modification. The following are the subfields that can be used with lastModifier query parameter:
- lastModifier.recordId : The unique identifier of the lastModifier object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=lastModifier.recordId eq '{id}' - lastModifier.email : User's email.
- lastModifier.firstName : User's firstName.
- lastModifier.lastName : User's lastName.
- lastModifier.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
Last ModifierRead Only:trueThe user or author who performed the last content modification. The following are the subfields that can be used with lastModifier query parameter:
- lastModifier.recordId : The unique identifier of the lastModifier object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=lastModifier.recordId eq '{id}' - lastModifier.email : User's email.
- lastModifier.firstName : User's firstName.
- lastModifier.lastName : User's lastName.
- lastModifier.login : User's login.
- lastModifier.recordId : The unique identifier of the lastModifier object. For example, to request an article with unique id, submit a call using the URI:
-
object
ContentKeyBO
Documentation for BO mode: ContentKeyBO
-
Title:
Latest ContentRead Only:trueLatest BO for this document.
arrayLinkstrueThe locale of the version of the document. The locale code represents the language and country associated with the Locale object. The following subfield can be used with locale query parameter:
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=locale.recordId eq 'es_ES'
-
object
LocaleKeyBO
Documentation for BO mode: LocaleKeyBO:
Localized Name of the Locale is currently NOT provided (i.e. The word Japanese is always in Japanese and never localized in say Arabic.)
-
Title:
LocaleThe locale of the version of the document. The locale code represents the language and country associated with the Locale object. The following subfield can be used with locale query parameter:
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=locale.recordId eq 'es_ES'
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
The user or author who owns or is responsible for the document. The following are the subfields that can be used with owner query parameter:
- owner.recordId : The unique identifier of the owner object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=owner.recordId eq '{id}' - owner.email : User's email.
- owner.firstName : User's firstName.
- owner.lastName : User's lastName.
- owner.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
OwnerRead Only:trueThe user or author who owns or is responsible for the document. The following are the subfields that can be used with owner query parameter:
- owner.recordId : The unique identifier of the owner object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=owner.recordId eq '{id}' - owner.email : User's email.
- owner.firstName : User's firstName.
- owner.lastName : User's lastName.
- owner.login : User's login.
- owner.recordId : The unique identifier of the owner object. For example, to request an article with unique id, submit a call using the URI:
arrayProducts-
Array of:
object ProductItemKeyBO
Documentation for BO mode: ProductItemKeyBO
-
object
ContentKeyBO
Documentation for BO mode: ContentKeyBO
-
Title:
Published ContentRead Only:truePublished BO for this document.
- CUSTOM(0)
- YES(1)
- YES_NO(2)
- THREE_STARS(3)
- FIVE_STARS(4)
-
object
DataFormBO
Documentation for BO mode: DataFormBO
-
Title:
RatingRead Only:trueDetermined whether it is a 5 star or Y/N type of rating.- CUSTOM(0)
- YES(1)
- YES_NO(2)
- THREE_STARS(3)
- FIVE_STARS(4)
-
object
AggregateFormResultsBO
Documentation for BO mode: AggregateFormResultsBO
-
Title:
Ratings AggregateRead Only:trueThe aggregate form results. This includes the average rating, the total responses, and the specific rating values for this article.
-
object
ContentReviewInformationBO
Content Review Information BO
-
Title:
Review InformationRead Only:trueReview information added after document marked as reviewed.
arraySchema Attributestrue-
Array of:
object SchemaAttributeBO
Documentation for BO mode: SchemaAttributeBO
-
object
ContentHistoryMetadataBO
Content History Metadata BO
-
Title:
sourceMetadataMetadata used to provide context to the action which created or modified this content.
arrayUser Groups-
Array of:
object UserGroupKeyBO
Documentation for BO mode: UserGroupKeyBO
arrayViewstrue-
Array of:
object ViewKeyBO
Documentation for BO mode: ViewKeyBO
-
object
WorkflowStepDataBO
Documentation for BO mode: WorkflowStepDataBO
-
Title:
Workflow StepRead Only:trueThe step of the workflow in which the document version currently exist.
object-
allTranslations: array
All Translations
Title:
All TranslationsRead Only:trueContains a collection of translations available of an article, if there are any. -
allVersions: array
All Versions
Title:
All VersionsRead Only:trueContains a collection of all versions of an article. -
answerId: integer
(int64)
Title:
Answer IDRead Only:trueThe unique identifier of an article in a locale. -
articleStatus:
articleStatus
-
autoCheckIn: boolean
Title:
Auto Check InRead Only:trueDefault Value:falseIndicates whether the article needs to be automatically checked in after saving it. -
autosave:
autosave
-
autosaveList: array
Autosave List
Title:
Autosave ListRead Only:trueContains a collection of autosaves that exist for an article, if there are any. -
basedLocale:
basedLocale
-
basedOnVersion: string
Title:
Based On VersionRead Only:trueMaximum Length:50If this article version is a localization, this field may contain the version of the article the localization was created from. -
checkedOut: boolean
Title:
Checked OutRead Only:trueDefault Value:falseThe date and time when an author has checked out or locked the document for editing. -
checkedOutBy:
checkedOutBy
-
contentType(required):
contentType
-
createDate: string
(date)
Title:
Create DateRead Only:trueThe date and time when this article was originally created. -
creator:
creator
-
dateAdded: string
(date)
Title:
Date AddedRead Only:trueThe date and time when this article version was created. -
dateModified: string
(date)
Title:
Date ModifiedRead Only:trueThe date and time when this article was last modified. -
displayEndDate: string
(date)
Title:
Display End DateThe date and time when the article will stop being available to display to end-users. -
displayReviewDate: string
(date)
Title:
Display Review DateThe date and time when the article requires a review by an author capable of performing the review. -
displayStartDate: string
(date)
Title:
Display Start DateThe date and time when the article will be available to display to end-users.. -
documentId: string
Title:
Document IDRead Only:trueThe unique identifier of an article most usable for humans. -
externalAssociations: object
Content External Associations
Title:
Content External AssociationsRead Only:trueAdditional Properties Allowed: ContentExternalAssociationBOThis field will return external associations of content such as a reference to an SR this article was created from. -
lastModifiedDate: string
(date)
Title:
Last Modified DateRead Only:trueThe date and time when this article was last modified. -
lastModifier:
lastModifier
-
latestContent:
latestContent
-
links: array
Links
Title:
LinksRead Only:trueREST API canonical and/or collection links for this Singular Resource -
locale(required):
locale
-
owner:
owner
-
pending: boolean
Title:
PendingRead Only:trueDefault Value:falseIndicates whether this article version is scheduled to go live in the future. The value is false for most article versions. -
publishDate: string
(date)
Title:
Publish DateRead Only:trueThe date and time when this article version was published. -
published: boolean
Title:
PublishedRead Only:trueDefault Value:falseIndicates whether this article version is published. Default value is false for all versions other than the published version, if there is one. -
publishedContent:
publishedContent
-
publishedVersion: string
Title:
Published VersionRead Only:trueMaximum Length:50If this article has a published version in the requested locale, this fields will contain the version number of the published article version. -
rating:
rating
-
ratingsAggregate:
ratingsAggregate
-
recordId: string
Title:
Record IDRead Only:trueThe unique identifier of the article. This ID is the same in all versions in all locales of the article and is recommended for programmatic use. -
reviewInformation:
reviewInformation
-
schemaAttributes: array
Schema Attributes
Title:
Schema AttributesRead Only:trueReturns information about the schema of an article. -
title: string
Title:
TitleRead Only:trueMaximum Length:4000The title of the document. -
version: string
Title:
VersionRead Only:trueMaximum Length:50The version of the article. -
versionId: string
Title:
Version IDRead Only:trueMaximum Length:64The unique identifier of the specific version of an article in a specific locale. You cannot use this field in queries made using q query parameter. -
versionState: string
Title:
Version StateRead Only:trueThe state of a version, possible values are SCHEDULED, LIVE, EXPIRED, DRAFT. -
workflowStep:
workflowStep
arrayAll Translationstrue-
Array of:
object ContentDataBO
Documentation for BO mode: ContentDataBO
arrayAll Versionstrue-
Array of:
object ContentKeyBO
Documentation for BO mode: ContentKeyBO
The article status.
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+in+('DRAFT', 'WORK_IN_PROGRESS')http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT' and contentState eq 'LATEST'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+eq+'IM_NULL_ARTICLE_STATUS'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+in+('IM_NULL_ARTICLE_STATUS', 'DRAFT')
The service response matches any Content object (PUBLISHED by default) with article status specified in the request if you pass the articleStatus.refKey parameter.
Example URIs for the articleStatus parameter are as follows:
OR
The following example URIs returns Content objects whose contentState is LATEST:
The following example URI returns Content objects with no article status assigned:
The following example URI returns Content objects with no article status assigned and Content objects with the Draft article status assigned:
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
-
object
ArticleStatusKeyBO
Documentation for BO mode: ArticleStatusKeyBO
-
Title:
Article StatusThe article status.
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+in+('DRAFT', 'WORK_IN_PROGRESS')http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT' and contentState eq 'LATEST'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+eq+'IM_NULL_ARTICLE_STATUS'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+in+('IM_NULL_ARTICLE_STATUS', 'DRAFT')
The service response matches any Content object (PUBLISHED by default) with article status specified in the request if you pass the
articleStatus.refKeyparameter.Example URIs for the articleStatus parameter are as follows:
OR
The following example URIs returns Content objects whose contentState is LATEST:
The following example URI returns Content objects with no article status assigned:
The following example URI returns Content objects with no article status assigned and Content objects with the Draft article status assigned:
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
-
object
ContentAutosaveKeyBO
-
Title:
AutosaveRead Only:trueautosave record.
arrayAutosave Listtrue-
object
LocaleKeyBO
Documentation for BO mode: LocaleKeyBO:
Localized Name of the Locale is currently NOT provided (i.e. The word Japanese is always in Japanese and never localized in say Arabic.)
-
Title:
Based LocaleThe source locale used to create the localized version of the document. This field is seen only if the content has a localized version.
The user or author who performed the last content checkout. The following are the subfields that can be used with checkedOutBy query parameter:
- checkedOutBy.recordId : The unique identifier of the checkedOutBy object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=checkedOutBy.recordId eq '{id}' - checkedOutBy.email : User's email.
- checkedOutBy.firstName : User's firstName.
- checkedOutBy.lastName : User's lastName.
- checkedOutBy.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
Checked Out ByRead Only:trueThe user or author who performed the last content checkout. The following are the subfields that can be used with checkedOutBy query parameter:
- checkedOutBy.recordId : The unique identifier of the checkedOutBy object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=checkedOutBy.recordId eq '{id}' - checkedOutBy.email : User's email.
- checkedOutBy.firstName : User's firstName.
- checkedOutBy.lastName : User's lastName.
- checkedOutBy.login : User's login.
- checkedOutBy.recordId : The unique identifier of the checkedOutBy object. For example, to request an article with unique id, submit a call using the URI:
The channel to which the content is categorized and saved. The following are the subfields that can be used with contentType query parameter:
- contentType.recordId : The unique identifier of the ContentType object.
- contentType.referenceKey : The reference key for the ContentType object. ContentType objects support multiple languages. This field can be used to identify the associated objects for all languages. For Example to request articles for content type FAQ, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=contentType.referenceKey eq 'FAQ' - contentType.allowRecommendations : The flag indicates whether the content type allows end users to create recommendations for its contents. This also indicates whether you can associate the recommended content with a content type.
-
object
ContentTypeKeyBO
Documentation for BO mode: ContentTypeKeyBO
-
Title:
Content TypeThe channel to which the content is categorized and saved. The following are the subfields that can be used with contentType query parameter:
- contentType.recordId : The unique identifier of the ContentType object.
- contentType.referenceKey : The reference key for the ContentType object. ContentType objects support multiple languages. This field can be used to identify the associated objects for all languages. For Example to request articles for content type FAQ, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=contentType.referenceKey eq 'FAQ' - contentType.allowRecommendations : The flag indicates whether the content type allows end users to create recommendations for its contents. This also indicates whether you can associate the recommended content with a content type.
The user who originally authored or created the document. The following are the subfields that can be used with creator query parameter:
- creator.recordId : The unique identifier of the creator object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=creator.recordId eq '{id}' - creator.email : User's email.
- creator.firstName : User's firstName.
- creator.lastName : User's lastName.
- creator.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
CreatorRead Only:trueThe user who originally authored or created the document. The following are the subfields that can be used with creator query parameter:
- creator.recordId : The unique identifier of the creator object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=creator.recordId eq '{id}' - creator.email : User's email.
- creator.firstName : User's firstName.
- creator.lastName : User's lastName.
- creator.login : User's login.
- creator.recordId : The unique identifier of the creator object. For example, to request an article with unique id, submit a call using the URI:
objectContent External Associationstrue-
object ContentExternalAssociationBO
Documentation for ContentExternalAssociationBO
The user or author who performed the last content modification. The following are the subfields that can be used with lastModifier query parameter:
- lastModifier.recordId : The unique identifier of the lastModifier object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=lastModifier.recordId eq '{id}' - lastModifier.email : User's email.
- lastModifier.firstName : User's firstName.
- lastModifier.lastName : User's lastName.
- lastModifier.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
Last ModifierRead Only:trueThe user or author who performed the last content modification. The following are the subfields that can be used with lastModifier query parameter:
- lastModifier.recordId : The unique identifier of the lastModifier object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=lastModifier.recordId eq '{id}' - lastModifier.email : User's email.
- lastModifier.firstName : User's firstName.
- lastModifier.lastName : User's lastName.
- lastModifier.login : User's login.
- lastModifier.recordId : The unique identifier of the lastModifier object. For example, to request an article with unique id, submit a call using the URI:
-
object
ContentKeyBO
Documentation for BO mode: ContentKeyBO
-
Title:
Latest ContentRead Only:trueLatest BO for this document.
arrayLinkstrueThe locale of the version of the document. The locale code represents the language and country associated with the Locale object. The following subfield can be used with locale query parameter:
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=locale.recordId eq 'es_ES'
-
object
LocaleKeyBO
Documentation for BO mode: LocaleKeyBO:
Localized Name of the Locale is currently NOT provided (i.e. The word Japanese is always in Japanese and never localized in say Arabic.)
-
Title:
LocaleThe locale of the version of the document. The locale code represents the language and country associated with the Locale object. The following subfield can be used with locale query parameter:
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=locale.recordId eq 'es_ES'
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
The user or author who owns or is responsible for the document. The following are the subfields that can be used with owner query parameter:
- owner.recordId : The unique identifier of the owner object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=owner.recordId eq '{id}' - owner.email : User's email.
- owner.firstName : User's firstName.
- owner.lastName : User's lastName.
- owner.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
OwnerRead Only:trueThe user or author who owns or is responsible for the document. The following are the subfields that can be used with owner query parameter:
- owner.recordId : The unique identifier of the owner object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=owner.recordId eq '{id}' - owner.email : User's email.
- owner.firstName : User's firstName.
- owner.lastName : User's lastName.
- owner.login : User's login.
- owner.recordId : The unique identifier of the owner object. For example, to request an article with unique id, submit a call using the URI:
-
object
ContentKeyBO
Documentation for BO mode: ContentKeyBO
-
Title:
Published ContentRead Only:truePublished BO for this document.
- CUSTOM(0)
- YES(1)
- YES_NO(2)
- THREE_STARS(3)
- FIVE_STARS(4)
-
object
DataFormBO
Documentation for BO mode: DataFormBO
-
Title:
RatingRead Only:trueDetermined whether it is a 5 star or Y/N type of rating.- CUSTOM(0)
- YES(1)
- YES_NO(2)
- THREE_STARS(3)
- FIVE_STARS(4)
-
object
AggregateFormResultsBO
Documentation for BO mode: AggregateFormResultsBO
-
Title:
Ratings AggregateRead Only:trueThe aggregate form results. This includes the average rating, the total responses, and the specific rating values for this article.
-
object
ContentReviewInformationBO
Content Review Information BO
-
Title:
Review InformationRead Only:trueReview information added after document marked as reviewed.
arraySchema Attributestrue-
Array of:
object SchemaAttributeBO
Documentation for BO mode: SchemaAttributeBO
-
object
WorkflowStepDataBO
Documentation for BO mode: WorkflowStepDataBO
-
Title:
Workflow StepRead Only:trueThe step of the workflow in which the document version currently exist.
object-
allTranslations: array
All Translations
Title:
All TranslationsRead Only:trueContains a collection of translations available of an article, if there are any. -
allVersions: array
All Versions
Title:
All VersionsRead Only:trueContains a collection of all versions of an article. -
answerId: integer
(int64)
Title:
Answer IDRead Only:trueThe unique identifier of an article in a locale. -
articleStatus:
articleStatus
-
autoCheckIn: boolean
Title:
Auto Check InRead Only:trueDefault Value:falseIndicates whether the article needs to be automatically checked in after saving it. -
autosave:
autosave
-
autosaveList: array
Autosave List
Title:
Autosave ListRead Only:trueContains a collection of autosaves that exist for an article, if there are any. -
dateModified: string
(date)
Title:
Date ModifiedRead Only:trueThe date and time when this article was last modified. -
displayEndDate: string
(date)
Title:
Display End DateThe date and time when the article will stop being available to display to end-users. -
displayReviewDate: string
(date)
Title:
Display Review DateThe date and time when the article requires a review by an author capable of performing the review. -
displayStartDate: string
(date)
Title:
Display Start DateThe date and time when the article will be available to display to end-users.. -
documentId: string
Title:
Document IDRead Only:trueThe unique identifier of an article most usable for humans. -
externalAssociations: object
Content External Associations
Title:
Content External AssociationsRead Only:trueAdditional Properties Allowed: ContentExternalAssociationBOThis field will return external associations of content such as a reference to an SR this article was created from. -
latestContent:
latestContent
-
links: array
Links
Title:
LinksRead Only:trueREST API canonical and/or collection links for this Singular Resource -
locale(required):
locale
-
publishedContent:
publishedContent
-
rating:
rating
-
ratingsAggregate:
ratingsAggregate
-
recordId: string
Title:
Record IDRead Only:trueThe unique identifier of the article. This ID is the same in all versions in all locales of the article and is recommended for programmatic use. -
reviewInformation:
reviewInformation
-
schemaAttributes: array
Schema Attributes
Title:
Schema AttributesRead Only:trueReturns information about the schema of an article. -
title: string
Title:
TitleRead Only:trueMaximum Length:4000The title of the document. -
version: string
Title:
VersionRead Only:trueMaximum Length:50The version of the article. -
versionId: string
Title:
Version IDRead Only:trueMaximum Length:64The unique identifier of the specific version of an article in a specific locale. You cannot use this field in queries made using q query parameter. -
versionState: string
Title:
Version StateRead Only:trueThe state of a version, possible values are SCHEDULED, LIVE, EXPIRED, DRAFT.
arrayAll Translationstrue-
Array of:
object ContentDataBO
Documentation for BO mode: ContentDataBO
arrayAll Versionstrue-
Array of:
object ContentKeyBO
Documentation for BO mode: ContentKeyBO
The article status.
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+in+('DRAFT', 'WORK_IN_PROGRESS')http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT' and contentState eq 'LATEST'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+eq+'IM_NULL_ARTICLE_STATUS'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+in+('IM_NULL_ARTICLE_STATUS', 'DRAFT')
The service response matches any Content object (PUBLISHED by default) with article status specified in the request if you pass the articleStatus.refKey parameter.
Example URIs for the articleStatus parameter are as follows:
OR
The following example URIs returns Content objects whose contentState is LATEST:
The following example URI returns Content objects with no article status assigned:
The following example URI returns Content objects with no article status assigned and Content objects with the Draft article status assigned:
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
-
object
ArticleStatusKeyBO
Documentation for BO mode: ArticleStatusKeyBO
-
Title:
Article StatusThe article status.
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+in+('DRAFT', 'WORK_IN_PROGRESS')http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT' and contentState eq 'LATEST'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+eq+'IM_NULL_ARTICLE_STATUS'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+in+('IM_NULL_ARTICLE_STATUS', 'DRAFT')
The service response matches any Content object (PUBLISHED by default) with article status specified in the request if you pass the
articleStatus.refKeyparameter.Example URIs for the articleStatus parameter are as follows:
OR
The following example URIs returns Content objects whose contentState is LATEST:
The following example URI returns Content objects with no article status assigned:
The following example URI returns Content objects with no article status assigned and Content objects with the Draft article status assigned:
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
-
object
ContentAutosaveKeyBO
-
Title:
AutosaveRead Only:trueautosave record.
arrayAutosave ListtrueobjectContent External Associationstrue-
object ContentExternalAssociationBO
Documentation for ContentExternalAssociationBO
-
object
ContentKeyBO
Documentation for BO mode: ContentKeyBO
-
Title:
Latest ContentRead Only:trueLatest BO for this document.
arrayLinkstrueThe locale of the version of the document. The locale code represents the language and country associated with the Locale object. The following subfield can be used with locale query parameter:
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=locale.recordId eq 'es_ES'
-
object
LocaleKeyBO
Documentation for BO mode: LocaleKeyBO:
Localized Name of the Locale is currently NOT provided (i.e. The word Japanese is always in Japanese and never localized in say Arabic.)
-
Title:
LocaleThe locale of the version of the document. The locale code represents the language and country associated with the Locale object. The following subfield can be used with locale query parameter:
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=locale.recordId eq 'es_ES'
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
-
object
ContentKeyBO
Documentation for BO mode: ContentKeyBO
-
Title:
Published ContentRead Only:truePublished BO for this document.
- CUSTOM(0)
- YES(1)
- YES_NO(2)
- THREE_STARS(3)
- FIVE_STARS(4)
-
object
DataFormBO
Documentation for BO mode: DataFormBO
-
Title:
RatingRead Only:trueDetermined whether it is a 5 star or Y/N type of rating.- CUSTOM(0)
- YES(1)
- YES_NO(2)
- THREE_STARS(3)
- FIVE_STARS(4)
-
object
AggregateFormResultsBO
Documentation for BO mode: AggregateFormResultsBO
-
Title:
Ratings AggregateRead Only:trueThe aggregate form results. This includes the average rating, the total responses, and the specific rating values for this article.
-
object
ContentReviewInformationBO
Content Review Information BO
-
Title:
Review InformationRead Only:trueReview information added after document marked as reviewed.
arraySchema Attributestrue-
Array of:
object SchemaAttributeBO
Documentation for BO mode: SchemaAttributeBO
object-
links: array
Links
Title:
LinksRead Only:trueThe collection links related to this resource -
name: string
Title:
NameRead Only:trueMinimum Length:1Maximum Length:255The localized name of the ArticleStatus object. The name field can only be used for sorting. -
recordId: string
Title:
Record IdThe unique identifier of the ArticleStatus object. -
referenceKey: string
Title:
Reference KeyMaximum Length:255The reference key for the ArticleStatus object. ArticleStatus objects support multiple languages. This field can be used to identify the associated objects for all languages.
arrayLinkstrueobject-
autosaveType(required):
autosaveType
-
dateAdded: string
(date)
Title:
Date AddedRead Only:trueThe date and time when this autosave was created. -
dateModified: string
(date)
Title:
Date ModifiedRead Only:trueThe date and time this autosave was last modified. -
documentId: string
Title:
Document IdRead Only:trueThe unique identifier of a document that indicates the content type in which the content is saved. -
locale: object
LocaleKeyBO
Documentation for BO mode: LocaleKeyBO:
Localized Name of the Locale is currently NOT provided (i.e. The word Japanese is always in Japanese and never localized in say Arabic.)
-
recordId: string
-
title: string
Maximum Length:
4000
-
string
Allowed Values:
[ "ALL", "CREATED", "EDITED", "TRANSLATED" ] -
objectLocalized Name of the Locale is currently NOT provided (i.e. The word Japanese is always in Japanese and never localized in say Arabic.)
-
links: array
Links
Title:
LinksRead Only:trueREST API canonical and/or collection links for this Singular Resource -
localeDesc: string
Title:
Locale DescRead Only:trueMaximum Length:100The description about the language and country that the Locale object represents. -
recordId: string
Title:
Record IdThe unique identifier of the Locale object.
arrayLinkstrueobject-
alternateId: string
Title:
Alternate IdThe alternate identifier of the external association -
alternateIdType: string
Title:
Alternate Id TypeThe alternate type of the external assocation -
objectId(required): string
Title:
Object IdMinimum Length:1Maximum Length:50The unique identifier of the external association. -
properties: object
Properties
Title:
PropertiesAdditional Properties Allowed: additionalPropertiesThe properties of the external association -
type(required): string
Title:
Object TypeMinimum Length:1Maximum Length:100The type of the external association
objectPropertiesobject-
dateAdded(required): string
(date)
Title:
Date AddedRead Only:trueThe date and time when this DataForm object was created. -
dateModified(required): string
(date)
Title:
Date ModifiedRead Only:trueThe date and time when this DataForm object was last modified. -
displayEndDate: string
(date)
Title:
Display End DateThe date when the service stops the display of the data form to the end users -
displayStartDate: string
(date)
Title:
Display Start DateThe date when the data form will be available to display to end-users -
emailContent: boolean
Title:
Email ContentThe emailContent field of the DataForm object -
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
name: string
Title:
NameMaximum Length:255The name of the data form. The name field can only be used for sorting. -
questions: array
Questions
Title:
QuestionsTo Many Relationship to Question -
ratingType: integer
(int32)
Title:
Rating TypeDetermined whether it is a 5 star or Y/N type of rating- CUSTOM(0)
- YES(1)
- YES_NO(2)
- THREE_STARS(3)
- FIVE_STARS(4)
-
recordId(required): string
Title:
Record IdRead Only:trueThe unique identifier of the DataForm object -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:255The reference key for the DataForm object -
user:
user
-
views: array
Views
Title:
ViewsTo Many Relationship to View
arrayLinksarrayQuestions-
Array of:
object DataFormQuestionBO
Documentation for BO mode: QuestionBO
arrayViews-
Array of:
object ViewKeyBO
Documentation for BO mode: ViewKeyBO
object-
answers: array
Answers
Title:
AnswersTo Many Relationship to Answer -
dataForm:
dataForm
-
dateAdded(required): string
(date)
Title:
Date AddedRead Only:trueThe date and time the DataFormQuestion object was created -
dateModified(required): string
(date)
Title:
Date ModifiedRead Only:trueThe date and time the DataFormQuestion object was last modified -
isMasterIdentifier: boolean
Title:
Is Master IdentifierThe isMasterIdentifier field of the DataFormQuestion object -
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
name(required): string
Title:
NameMinimum Length:1Maximum Length:255The localized name of the DataFormQuestion object -
recordId(required): string
Title:
Record IdRead Only:trueThe unique identifier of the DataFormQuestion object -
referenceKey: string
Title:
Reference KeyMaximum Length:255The reference key for the DataFormQuestion object -
required: boolean
Title:
RequiredThe flag that indicates whether or not this question is required -
sortOrder: integer
(int32)
Title:
Sort OrderThe sort order of this question -
specialTypeIndicator: integer
(int32)
Title:
Special Type IndicatorThe specialTypeIndicator field of the DataFormQuestion object
arrayAnswers-
Array of:
object DataFormAnswerBO
Documentation for BO mode: AnswerBO
-
object
DataFormKeyBO
Documentation for BO mode: DataFormKeyBO
-
Title:
Data FormRelationship to Rating
arrayLinksobject-
dataFormQuestion:
dataFormQuestion
-
dateAdded(required): string
(date)
Title:
Date AddedRead Only:trueThe date and time when this DataFormAnswer object was created. -
dateModified(required): string
(date)
Title:
Date ModifiedRead Only:trueThe date and time when this DataFormAnswer object was last modified. -
defaultAnswer: boolean
Title:
Default AnswerThe flag that indicates whether or not this answer is the default answer -
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
name(required): string
Title:
NameMinimum Length:1Maximum Length:255The localized name of the DataFormAnswer object -
numberValue: integer
(int32)
Title:
Number ValueThe numeric value of the answer -
recordId(required): string
Title:
Record IdRead Only:trueThe unique identifier of the DataFormAnswer object -
referenceKey: string
Title:
Reference KeyMaximum Length:255The reference key for the DataFormAnswer object -
sortOrder: integer
(int32)
Title:
Sort OrderThe sort order of the answer
-
object
DataFormQuestionKeyBO
Documentation for BO mode: QuestionKeyBO
-
Title:
Data Form QuestionRelationship to Question
arrayLinksobject-
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
recordId(required): string
Title:
Record IdRead Only:trueThe unique identifier of the DataFormQuestion object -
referenceKey: string
Title:
Reference KeyMaximum Length:255The reference key for the DataFormQuestion object
arrayLinksobject-
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
recordId(required): string
Title:
Record IdRead Only:trueThe unique identifier of the DataForm object -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:255The reference key for the DataForm object
arrayLinksobject-
canAssignTask: boolean
Title:
Can Assign tasksReturns whether this user can assign tasks to other users. -
contentTypePrivileges: array
Content Type Privileges
Title:
Content Type PrivilegesThis field will return list of all contenttype privileges user have -
email: string
Title:
EmailMaximum Length:100The user's e-mail address -
externalId: integer
(int64)
Title:
External IdRead Only:trueThe ExternalId is the Id of the corresponding User from an external system. It, along with ExternalType, can be used to bridge the gap between a User from this system and a User from an external system. -
functionalPrivileges: object
Functional Privileges of user
Title:
Functional Privileges of userAdditional Properties Allowed: additionalPropertiesThis field will return list of all fucntional privileges user have -
links: array
Links
Title:
LinksRead Only:trueREST API canonical and/or collection links for this Singular Resource -
login: string
Title:
LoginMaximum Length:100The user's login -
name: string
Title:
NameRead Only:trueMaximum Length:100User's full name -
recordId(required): integer
(int64)
Title:
Record IdRead Only:trueThe unique identifier of the user
arrayContent Type Privileges-
Array of:
object CompositeContentTypeBO
Composite of ContentTypeBO and its flattened relation. Keep in mind we can add more stuff down the line
objectFunctional Privileges of user arrayLinkstrueobject-
compositeWorkflowSteps(required): array
WorkflowSteps Composite BO
Title:
WorkflowSteps Composite BOWorkflowSteps mapped to this content type and user privileges on that -
contentTypeKeyBO(required):
contentTypeKeyBO
-
hasContentTypeAccess: boolean
Title:
Has Content Type AccessVerifies if ContentTypeBO privileges are valid for user -
listOfPrivilege(required): array
List Of Privilege
Title:
List Of PrivilegeList of Privileges for the ContentType
arrayWorkflowSteps Composite BO-
Array of:
object CompositeWorkflowStepBO
Composite of WorkflowStepBO with user privileges on this step.
-
object
ContentTypeKeyBO
Documentation for BO mode: ContentTypeKeyBO
-
Title:
Content Type Key BOContentBO object being created or updated
arrayList Of Privilegeobject-
listOfPrivilege(required): array
List Of Privilege
Title:
List Of PrivilegeList of Privileges for the WorkflowStep -
WorkflowStepKeyBO(required):
WorkflowStepKeyBO
arrayList Of Privilege-
object
WorkflowStepKeyBO
Documentation for BO mode: WorkflowStepKeyBO
-
Title:
WorkflowStep Key BOWorkflowStep object being fetched
object-
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
name: string
Title:
NameMaximum Length:255Localized name of the workflow step -
recordId(required): string
Title:
Record IdRead Only:trueGUID from the WORKFLOWSTEP table -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:100Non localized name of the workflow step -
workflowId(required): string
Title:
WorkflowRecord IdRead Only:trueGUID from the WORKFLOW table
arrayLinksobject-
description: string
Title:
DescriptionMaximum Length:255The description for the ContentType object. Content Types support multiple languages. This field identifies the object associated with the language specified by the user. -
links: array
Links
Title:
LinksRead Only:trueREST API canonical and/or collection links for this Singular Resource -
name(required): string
Title:
NameMinimum Length:1Maximum Length:255The name for the ContentType object. The name field can only be used for sorting. Content Types support multiple languages. This field identifies the object associated with the language specified by the user. -
recordId: string
Title:
Record IdRead Only:trueThe unique identifier of the ContentType object. -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:255The reference key for the ContentType object. ContentType objects support multiple languages. This field can be used to identify the associated objects for all languages. -
stripeCd(required): string
Title:
Stripe CdMaximum Length:30Lookup code that indicates the stripe code. -
usageCode: string
Title:
Usage CodeRead Only:trueMaximum Length:30Lookup code that indicates the product usage code. -
workflow:
workflow
arrayLinkstrue-
object
WorkflowKeyBO
-
Title:
WorkflowThe workflow definition that the author can use while content authoring in a content type.
object-
enabled: boolean
-
links: array
links
-
name: string
Maximum Length:
255 -
recordId: string
-
referenceKey: string
Minimum Length:
0Maximum Length:100 -
workflowVersion: integer
(int32)
object-
links: array
Links
Title:
LinksRead Only:trueREST API canonical and/or collection links for this Singular Resource -
name: string
Title:
NameMaximum Length:255Localized name of the view -
recordId(required): string
Title:
Record IdRead Only:trueGUID of the SITE table containing the view definition -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:255Non localized reference key for the view -
stripeCd: string
Title:
Stripe CDMaximum Length:30Stripe of a view
arrayLinkstrueobject-
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
questions: array
Questions
Title:
QuestionsTo Many Relationship to AggregateQuestionResult -
recordId(required): string
Title:
Record IdRead Only:trueThe unique record ID of the AggregateFormResults object. -
referenceKey: string
Title:
Reference KeyMaximum Length:255The reference key for the AggregateFormResults object. AggregateFormResults objects support multiple languages. This field can be used to identify the associated objects for all languages. -
totalResponses: integer
(int64)
Title:
Total ResponsesTotalResponses of the AggregateFormResults object
arrayLinksarrayQuestions-
Array of:
object AggregateQuestionResultBO
Documentation for BO mode: AggregateQuestionResultBO
object-
answers: array
Answers
Title:
AnswersTo Many Relationship to AggregateAnswerResult -
averageResponse: number
(double)
Title:
Average ResponseAverageResponse of the AggregateQuestionResult object -
name(required): string
Title:
NameMinimum Length:1Maximum Length:255Localized display name for the Question -
recordId(required): string
Title:
Record IdRead Only:trueThe unique record ID of the AggregateQuestionResult object. -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:255The reference key for the AggregateQuestionResult object. AggregateQuestionResult objects support multiple languages. This field can be used to identify the associated objects for all languages. -
totalResponses: integer
(int64)
Title:
Total ResponsesTotalResponses of the AggregateQuestionResult object
arrayAnswers-
Array of:
object AggregateAnswerResultBO
Documentation for BO mode: AggregateAnswerResultBO
object-
name(required): string
Title:
NameMinimum Length:1Maximum Length:255Localized display name for the Answer -
recordId(required): string
Title:
Record IdRead Only:trueThe unique record ID of the AggregateAnswerResult object. -
referenceKey: string
Title:
Reference KeyMaximum Length:255The reference key for the AggregateAnswerResult object. AggregateAnswerResult objects support multiple languages. This field can be used to identify the associated objects for all languages. -
totalResponses: integer
(int64)
Title:
Total ResponsesTotalResponses of the AggregateAnswerResult object
object-
lastUpdateDate: string
(date)
Title:
Last Update DateRead Only:trueThe date when the document was marked reviewed. -
lastUpdatedBy:
lastUpdatedBy
-
state:
state
-
string
Allowed Values:
[ "REVIEWED" ] -
Title:
StateRead Only:truereview state for document.
object-
allowMultipleNodes: boolean
Title:
Allow Multiple NodesFlag indicating if multiple nodes are allowed of this type@since 8.3 -
allowPreselectedUserGroupChange: boolean
Title:
Allow Preselected User Group ChangeEnable editors to modify preselected user group restrictions@since 8.3 -
children: array
Children
Title:
ChildrenList of child nodes of the current element -
counter: integer
(int32)
Title:
CounterThis attribute contains the current value of the ContentType DOC ID counter. This value should not be changed after content is added to the ContentType -
counterPrefix: string
Title:
Counter PrefixMaximum Length:50This attribute contains the prefix that is appended to the front of the DOC ID counter -
dateAdded: string
(date)
Title:
Date AddedRead Only:trueThe date and time when this SchemaAttribute definition was first created -
dateModified: string
(date)
Title:
Date ModifiedRead Only:trueThe date and time when this SchemaAttribute definition was last modified -
description: string
Title:
DescriptionMaximum Length:1000Localized help text for the attribute. This text is displayed in the authoring view -
enableAttributeLevelSearch: boolean
Title:
Enable Attribute Level SearchFlag indicating whether this field should be configured for attribute level searching - i.e. where TITLE='xyz'. This fieldwas previously called searchable@since 8.3 -
enableFullTextSearch: boolean
Title:
Enable Full Text SearchFlag indicating whether this field should be included in the full text index. This field was previouslycalled indexable@since 8.3 -
includeInMasterIdentifier: boolean
Title:
Include In Master IdentifierFlag indicating whether this field should be appended to the master identifier of the document -
isNode: boolean
Title:
Is NodeFlag indicating if this element is a node@since 8.3 -
isRequired: boolean
Title:
Is RequiredMake attribute a required field@since 8.3 -
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
localizedAttributes: array
Localized Attributes
Title:
Localized AttributesList of LocalizedAttributes of this SchemaAttribute name and description in various Locales -
name(required): string
Title:
NameMinimum Length:1Maximum Length:255Localized name of the attribute. This need NOT be unique within the Schema. -
readOnly: boolean
Title:
Read OnlyFlag indicating whether this field is editable -
recordId: string
Title:
Record IdRead Only:trueUnique identifier for the SchemaAttribute object -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:100Non localized name of the attribute.SchemaAttribute's referenceKey need NOT be unique within its Schema.But its xpath will be unique within its Schema. -
requireWorkflowApproval: boolean
Title:
Require Workflow ApprovalAttribute requires workflow approval if workflow is enabled -
schemaAttributeUserGroupList: array
Schema Attribute User Group List
Title:
Schema Attribute User Group ListList of user groups that can be used to secure this attribute. This should be a subset of the list of user groups assigned to the ContentType -
schemaAttrType:
schemaAttrType
-
securedFileResource: boolean
Title:
Secured File ResourceFlag indicating if this attribute (file types only) should be marked as secure - i.e. stored in the ~secure folder near the content XML file -
secureWithUserGroups: boolean
Title:
Secure With User GroupsRestrict attribute to selected user groups -
securityRegex: string
Title:
Security RegexMaximum Length:100The regular expression used to validate the field against security attacks. -
sortOrder: integer
(int32)
Title:
Sort OrderDisplay order of the schema attributes within the edit form -
textHeight: string
Title:
Text HeightMaximum Length:10Specifies the text height for text areas and rich text fields -
textWidth: string
Title:
Text WidthMaximum Length:10Specifies the max length for text fields -
userGroupSelectionRequired: boolean
Title:
User Group Selection RequiredUser groups are required for attribute -
wysiwygType:
wysiwygType
-
xpath: string
Title:
XpathMaximum Length:2000The XPATH of this attribute within the schema. This is unique within the Schema.
arrayChildren-
Array of:
object SchemaAttributeBO
Documentation for BO mode: SchemaAttributeBO
arrayLinksarrayLocalized AttributesarraySchema Attribute User Group List-
string
Allowed Values:
[ "BOOLEAN", "COUNTER", "DATE", "DATETIME", "FILE", "FLOAT", "INTEGER", "LIST", "TEXT_AREA", "TEXT_FIELD", "TIME", "WYSIWYG_EDIT" ] -
Title:
Schema Attr TypeEnumerated type representing the type of attribute - i.e. text field, rich text area
-
string
Allowed Values:
[ "BASIC", "FULL", "MEDIUM" ] -
Title:
Wysiwyg TypeType of WYSIWYG rich text field - i.e. FULL, BASIC, MEDIUM@since 8.3
object-
description: string
Title:
DescriptionMaximum Length:1000Localized description in the above Locale -
localeId(required): string
Title:
Locale IdRead Only:trueRecordId of the Locale - generally this is the localeCode (like en_US) and NOT a real GUID. -
name(required): string
Title:
NameMinimum Length:1Maximum Length:255Localized Name in the above Locale
object-
defaultValue: boolean
-
recordId: string
-
userGroup: object
UserGroupKeyBO
Documentation for BO mode: UserGroupKeyBO
object-
links: array
Links
Title:
LinksRead Only:trueThe collection links related to this resource -
name: string
Title:
NameRead Only:trueMaximum Length:255The localized name of the user group. The name field can only be used for sorting. -
recordId: string
Title:
Record IdThe unique identifier from the TAG table that represent a userGroups resource -
referenceKey: string
Title:
Reference KeyMaximum Length:255The non localized name of the user group -
stripeCd: string
Title:
Stripe CDRead Only:trueMaximum Length:30Stripe for UserGroup
arrayLinkstrueobject-
allowDocumentEditing: boolean
Title:
Allow Document EditingFlag indicating whether this step allows document editing -
dateAdded(required): string
(date)
Title:
Date AddedRead Only:trueThe date and time when this work flow step was added. -
dateModified(required): string
(date)
Title:
Date ModifiedRead Only:trueThe date and time when this work flow step was last modified. -
defaultStepDurationInMinutes: integer
(int32)
Title:
Default Workflow Step Due date in minutesTime in minutes that the workflow step task will stay in queue before being consdiered overdue -
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
name: string
Title:
NameMaximum Length:255Localized name of the workflow step -
onlyAssigneeCanAppove: boolean
Title:
Can only assignee approve stepFlag indicating whether this step can only be approved by workflow step task assignee -
recordId(required): string
Title:
Record IdRead Only:trueGUID from the WORKFLOWSTEP table -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:100Non localized name of the workflow step -
sortOrder: integer
(int32)
Title:
Sort OrderThe order of the workflow steps within the workflow -
workflowId(required): string
Title:
WorkflowRecord IdRead Only:trueGUID from the WORKFLOW table
arrayLinksobject-
categoryId(required): integer
(int64)
Title:
Category IdThe unique identifier of the category.
object-
inventoryItemId: integer
(int64)
Title:
Inventory Item IdThe unique identifier of the product. -
organizationId: integer
(int64)
Title:
Organization IdThe inventory organization id of the specific category. -
productGroupId: integer
(int64)
Title:
Product Group IdThe unique identifier of the product group.
object-
externalAssociations: object
Content External Associations
Title:
Content External AssociationsRead Only:trueAdditional Properties Allowed: ContentExternalAssociationBOThis field will return external associations of content. -
operation: string
Title:
OperationThe action this metadata is providing context for. -
sourceDocId: string
Title:
Source Doc IdRead Only:truedocId of the article being copied. -
sourceLocaleId: string
Title:
Source Locale IdRead Only:trueThe locale of the article being copied or reverted to. -
sourceVersion: string
Title:
Source VersionRead Only:trueThe version of the article being copied or reverted to. -
sourceVersionId: string
Title:
Source Version IdThe versionId of the acticle being copied.
objectContent External Associationstrue-
object ContentExternalAssociationBO
Documentation for ContentExternalAssociationBO
Response
- application/json
200 Response
201 Response
object-
allTranslations: array
All Translations
Title:
All TranslationsRead Only:trueContains a collection of translations available of an article, if there are any. -
allVersions: array
All Versions
Title:
All VersionsRead Only:trueContains a collection of all versions of an article. -
answerId: integer
(int64)
Title:
Answer IDRead Only:trueThe unique identifier of an article in a locale. -
articleStatus:
articleStatus
-
autoCheckIn: boolean
Title:
Auto Check InRead Only:trueDefault Value:falseIndicates whether the article needs to be automatically checked in after saving it. -
autosave:
autosave
-
autosaveList: array
Autosave List
Title:
Autosave ListRead Only:trueContains a collection of autosaves that exist for an article, if there are any. -
basedLocale:
basedLocale
-
basedOnVersion: string
Title:
Based On VersionRead Only:trueMaximum Length:50If this article version is a localization, this field may contain the version of the article the localization was created from. -
categories: array
Categories
Title:
CategoriesThe list of categories associated with the article. -
checkedOut: boolean
Title:
Checked OutRead Only:trueDefault Value:falseThe date and time when an author has checked out or locked the document for editing. -
checkedOutBy:
checkedOutBy
-
contentBody(required): object
Content Body
Title:
Content BodyContents of the article. -
contentType(required):
contentType
-
createDate: string
(date)
Title:
Create DateRead Only:trueThe date and time when this article was originally created. -
creator:
creator
-
dateAdded: string
(date)
Title:
Date AddedRead Only:trueThe date and time when this article version was created. -
dateModified: string
(date)
Title:
Date ModifiedRead Only:trueThe date and time when this article was last modified. -
displayEndDate: string
(date)
Title:
Display End DateThe date and time when the article will stop being available to display to end-users. -
displayReviewDate: string
(date)
Title:
Display Review DateThe date and time when the article requires a review by an author capable of performing the review. -
displayStartDate: string
(date)
Title:
Display Start DateThe date and time when the article will be available to display to end-users.. -
documentId: string
Title:
Document IDRead Only:trueThe unique identifier of an article most usable for humans. -
externalAssociations: object
Content External Associations
Title:
Content External AssociationsRead Only:trueAdditional Properties Allowed: ContentExternalAssociationBOThis field will return external associations of content such as a reference to an SR this article was created from. -
isForEdit: boolean
Title:
Is For EditRead Only:trueDefault Value:falseIndicates whether the purpose of the request was to get an editable version of an article. Default value is false. -
lastModifiedDate: string
(date)
Title:
Last Modified DateRead Only:trueThe date and time when this article was last modified. -
lastModifier:
lastModifier
-
latestContent:
latestContent
-
links: array
Links
Title:
LinksRead Only:trueREST API canonical and/or collection links for this Singular Resource -
locale(required):
locale
-
owner:
owner
-
pending: boolean
Title:
PendingRead Only:trueDefault Value:falseIndicates whether this article version is scheduled to go live in the future. The value is false for most article versions. -
products: array
Products
Title:
ProductsThe list of products associated with the article. -
publishDate: string
(date)
Title:
Publish DateRead Only:trueThe date and time when this article version was published. -
published: boolean
Title:
PublishedRead Only:trueDefault Value:falseIndicates whether this article version is published. Default value is false for all versions other than the published version, if there is one. -
publishedContent:
publishedContent
-
publishedVersion: string
Title:
Published VersionRead Only:trueMaximum Length:50If this article has a published version in the requested locale, this fields will contain the version number of the published article version. -
rating:
rating
-
ratingsAggregate:
ratingsAggregate
-
reasonForEdit: string
Title:
Reason For EditMaximum Length:2000Reasons for editing or creating an article version. -
recordId: string
Title:
Record IDRead Only:trueThe unique identifier of the article. This ID is the same in all versions in all locales of the article and is recommended for programmatic use. -
reviewInformation:
reviewInformation
-
schemaAttributes: array
Schema Attributes
Title:
Schema AttributesRead Only:trueReturns information about the schema of an article. -
sourceMetadata:
sourceMetadata
-
title: string
Title:
TitleRead Only:trueMaximum Length:4000The title of the document. -
userGroups: array
User Groups
Title:
User GroupsThe user groups assigned to the content. Only the members of the assigned user group will have access to the content. Default value is Everyone. -
version: string
Title:
VersionRead Only:trueMaximum Length:50The version of the article. -
versionId: string
Title:
Version IDRead Only:trueMaximum Length:64The unique identifier of the specific version of an article in a specific locale. You cannot use this field in queries made using q query parameter. -
versionState: string
Title:
Version StateRead Only:trueThe state of a version, possible values are SCHEDULED, LIVE, EXPIRED, DRAFT. -
views: array
Views
Title:
ViewsRead Only:trueThe views assigned to the content. The user who has the view assigned to the content or the content type in which the content is saved can only access the content. -
workflowStep:
workflowStep
arrayAll Translationstrue-
Array of:
object ContentDataBO
Documentation for BO mode: ContentDataBO
arrayAll Versionstrue-
Array of:
object ContentKeyBO
Documentation for BO mode: ContentKeyBO
The article status.
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+in+('DRAFT', 'WORK_IN_PROGRESS')http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT' and contentState eq 'LATEST'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+eq+'IM_NULL_ARTICLE_STATUS'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+in+('IM_NULL_ARTICLE_STATUS', 'DRAFT')
The service response matches any Content object (PUBLISHED by default) with article status specified in the request if you pass the articleStatus.refKey parameter.
Example URIs for the articleStatus parameter are as follows:
OR
The following example URIs returns Content objects whose contentState is LATEST:
The following example URI returns Content objects with no article status assigned:
The following example URI returns Content objects with no article status assigned and Content objects with the Draft article status assigned:
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
-
object
ArticleStatusKeyBO
Documentation for BO mode: ArticleStatusKeyBO
-
Title:
Article StatusThe article status.
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+in+('DRAFT', 'WORK_IN_PROGRESS')http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT' and contentState eq 'LATEST'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+eq+'IM_NULL_ARTICLE_STATUS'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+in+('IM_NULL_ARTICLE_STATUS', 'DRAFT')
The service response matches any Content object (PUBLISHED by default) with article status specified in the request if you pass the
articleStatus.refKeyparameter.Example URIs for the articleStatus parameter are as follows:
OR
The following example URIs returns Content objects whose contentState is LATEST:
The following example URI returns Content objects with no article status assigned:
The following example URI returns Content objects with no article status assigned and Content objects with the Draft article status assigned:
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
-
object
ContentAutosaveKeyBO
-
Title:
AutosaveRead Only:trueautosave record.
arrayAutosave Listtrue-
object
LocaleKeyBO
Documentation for BO mode: LocaleKeyBO:
Localized Name of the Locale is currently NOT provided (i.e. The word Japanese is always in Japanese and never localized in say Arabic.)
-
Title:
Based LocaleThe source locale used to create the localized version of the document. This field is seen only if the content has a localized version.
arrayCategories-
Array of:
object CategoryItemKeyBO
Documentation for BO mode: CategoryItemKeyBO
The user or author who performed the last content checkout. The following are the subfields that can be used with checkedOutBy query parameter:
- checkedOutBy.recordId : The unique identifier of the checkedOutBy object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=checkedOutBy.recordId eq '{id}' - checkedOutBy.email : User's email.
- checkedOutBy.firstName : User's firstName.
- checkedOutBy.lastName : User's lastName.
- checkedOutBy.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
Checked Out ByRead Only:trueThe user or author who performed the last content checkout. The following are the subfields that can be used with checkedOutBy query parameter:
- checkedOutBy.recordId : The unique identifier of the checkedOutBy object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=checkedOutBy.recordId eq '{id}' - checkedOutBy.email : User's email.
- checkedOutBy.firstName : User's firstName.
- checkedOutBy.lastName : User's lastName.
- checkedOutBy.login : User's login.
- checkedOutBy.recordId : The unique identifier of the checkedOutBy object. For example, to request an article with unique id, submit a call using the URI:
objectContent BodyThe channel to which the content is categorized and saved. The following are the subfields that can be used with contentType query parameter:
- contentType.recordId : The unique identifier of the ContentType object.
- contentType.referenceKey : The reference key for the ContentType object. ContentType objects support multiple languages. This field can be used to identify the associated objects for all languages. For Example to request articles for content type FAQ, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=contentType.referenceKey eq 'FAQ' - contentType.allowRecommendations : The flag indicates whether the content type allows end users to create recommendations for its contents. This also indicates whether you can associate the recommended content with a content type.
-
object
ContentTypeKeyBO
Documentation for BO mode: ContentTypeKeyBO
-
Title:
Content TypeThe channel to which the content is categorized and saved. The following are the subfields that can be used with contentType query parameter:
- contentType.recordId : The unique identifier of the ContentType object.
- contentType.referenceKey : The reference key for the ContentType object. ContentType objects support multiple languages. This field can be used to identify the associated objects for all languages. For Example to request articles for content type FAQ, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=contentType.referenceKey eq 'FAQ' - contentType.allowRecommendations : The flag indicates whether the content type allows end users to create recommendations for its contents. This also indicates whether you can associate the recommended content with a content type.
The user who originally authored or created the document. The following are the subfields that can be used with creator query parameter:
- creator.recordId : The unique identifier of the creator object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=creator.recordId eq '{id}' - creator.email : User's email.
- creator.firstName : User's firstName.
- creator.lastName : User's lastName.
- creator.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
CreatorRead Only:trueThe user who originally authored or created the document. The following are the subfields that can be used with creator query parameter:
- creator.recordId : The unique identifier of the creator object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=creator.recordId eq '{id}' - creator.email : User's email.
- creator.firstName : User's firstName.
- creator.lastName : User's lastName.
- creator.login : User's login.
- creator.recordId : The unique identifier of the creator object. For example, to request an article with unique id, submit a call using the URI:
objectContent External Associationstrue-
object ContentExternalAssociationBO
Documentation for ContentExternalAssociationBO
The user or author who performed the last content modification. The following are the subfields that can be used with lastModifier query parameter:
- lastModifier.recordId : The unique identifier of the lastModifier object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=lastModifier.recordId eq '{id}' - lastModifier.email : User's email.
- lastModifier.firstName : User's firstName.
- lastModifier.lastName : User's lastName.
- lastModifier.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
Last ModifierRead Only:trueThe user or author who performed the last content modification. The following are the subfields that can be used with lastModifier query parameter:
- lastModifier.recordId : The unique identifier of the lastModifier object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=lastModifier.recordId eq '{id}' - lastModifier.email : User's email.
- lastModifier.firstName : User's firstName.
- lastModifier.lastName : User's lastName.
- lastModifier.login : User's login.
- lastModifier.recordId : The unique identifier of the lastModifier object. For example, to request an article with unique id, submit a call using the URI:
-
object
ContentKeyBO
Documentation for BO mode: ContentKeyBO
-
Title:
Latest ContentRead Only:trueLatest BO for this document.
arrayLinkstrueThe locale of the version of the document. The locale code represents the language and country associated with the Locale object. The following subfield can be used with locale query parameter:
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=locale.recordId eq 'es_ES'
-
object
LocaleKeyBO
Documentation for BO mode: LocaleKeyBO:
Localized Name of the Locale is currently NOT provided (i.e. The word Japanese is always in Japanese and never localized in say Arabic.)
-
Title:
LocaleThe locale of the version of the document. The locale code represents the language and country associated with the Locale object. The following subfield can be used with locale query parameter:
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=locale.recordId eq 'es_ES'
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
The user or author who owns or is responsible for the document. The following are the subfields that can be used with owner query parameter:
- owner.recordId : The unique identifier of the owner object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=owner.recordId eq '{id}' - owner.email : User's email.
- owner.firstName : User's firstName.
- owner.lastName : User's lastName.
- owner.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
OwnerRead Only:trueThe user or author who owns or is responsible for the document. The following are the subfields that can be used with owner query parameter:
- owner.recordId : The unique identifier of the owner object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=owner.recordId eq '{id}' - owner.email : User's email.
- owner.firstName : User's firstName.
- owner.lastName : User's lastName.
- owner.login : User's login.
- owner.recordId : The unique identifier of the owner object. For example, to request an article with unique id, submit a call using the URI:
arrayProducts-
Array of:
object ProductItemKeyBO
Documentation for BO mode: ProductItemKeyBO
-
object
ContentKeyBO
Documentation for BO mode: ContentKeyBO
-
Title:
Published ContentRead Only:truePublished BO for this document.
- CUSTOM(0)
- YES(1)
- YES_NO(2)
- THREE_STARS(3)
- FIVE_STARS(4)
-
object
DataFormBO
Documentation for BO mode: DataFormBO
-
Title:
RatingRead Only:trueDetermined whether it is a 5 star or Y/N type of rating.- CUSTOM(0)
- YES(1)
- YES_NO(2)
- THREE_STARS(3)
- FIVE_STARS(4)
-
object
AggregateFormResultsBO
Documentation for BO mode: AggregateFormResultsBO
-
Title:
Ratings AggregateRead Only:trueThe aggregate form results. This includes the average rating, the total responses, and the specific rating values for this article.
-
object
ContentReviewInformationBO
Content Review Information BO
-
Title:
Review InformationRead Only:trueReview information added after document marked as reviewed.
arraySchema Attributestrue-
Array of:
object SchemaAttributeBO
Documentation for BO mode: SchemaAttributeBO
-
object
ContentHistoryMetadataBO
Content History Metadata BO
-
Title:
sourceMetadataMetadata used to provide context to the action which created or modified this content.
arrayUser Groups-
Array of:
object UserGroupKeyBO
Documentation for BO mode: UserGroupKeyBO
arrayViewstrue-
Array of:
object ViewKeyBO
Documentation for BO mode: ViewKeyBO
-
object
WorkflowStepDataBO
Documentation for BO mode: WorkflowStepDataBO
-
Title:
Workflow StepRead Only:trueThe step of the workflow in which the document version currently exist.
object-
allTranslations: array
All Translations
Title:
All TranslationsRead Only:trueContains a collection of translations available of an article, if there are any. -
allVersions: array
All Versions
Title:
All VersionsRead Only:trueContains a collection of all versions of an article. -
answerId: integer
(int64)
Title:
Answer IDRead Only:trueThe unique identifier of an article in a locale. -
articleStatus:
articleStatus
-
autoCheckIn: boolean
Title:
Auto Check InRead Only:trueDefault Value:falseIndicates whether the article needs to be automatically checked in after saving it. -
autosave:
autosave
-
autosaveList: array
Autosave List
Title:
Autosave ListRead Only:trueContains a collection of autosaves that exist for an article, if there are any. -
basedLocale:
basedLocale
-
basedOnVersion: string
Title:
Based On VersionRead Only:trueMaximum Length:50If this article version is a localization, this field may contain the version of the article the localization was created from. -
checkedOut: boolean
Title:
Checked OutRead Only:trueDefault Value:falseThe date and time when an author has checked out or locked the document for editing. -
checkedOutBy:
checkedOutBy
-
contentType(required):
contentType
-
createDate: string
(date)
Title:
Create DateRead Only:trueThe date and time when this article was originally created. -
creator:
creator
-
dateAdded: string
(date)
Title:
Date AddedRead Only:trueThe date and time when this article version was created. -
dateModified: string
(date)
Title:
Date ModifiedRead Only:trueThe date and time when this article was last modified. -
displayEndDate: string
(date)
Title:
Display End DateThe date and time when the article will stop being available to display to end-users. -
displayReviewDate: string
(date)
Title:
Display Review DateThe date and time when the article requires a review by an author capable of performing the review. -
displayStartDate: string
(date)
Title:
Display Start DateThe date and time when the article will be available to display to end-users.. -
documentId: string
Title:
Document IDRead Only:trueThe unique identifier of an article most usable for humans. -
externalAssociations: object
Content External Associations
Title:
Content External AssociationsRead Only:trueAdditional Properties Allowed: ContentExternalAssociationBOThis field will return external associations of content such as a reference to an SR this article was created from. -
lastModifiedDate: string
(date)
Title:
Last Modified DateRead Only:trueThe date and time when this article was last modified. -
lastModifier:
lastModifier
-
latestContent:
latestContent
-
links: array
Links
Title:
LinksRead Only:trueREST API canonical and/or collection links for this Singular Resource -
locale(required):
locale
-
owner:
owner
-
pending: boolean
Title:
PendingRead Only:trueDefault Value:falseIndicates whether this article version is scheduled to go live in the future. The value is false for most article versions. -
publishDate: string
(date)
Title:
Publish DateRead Only:trueThe date and time when this article version was published. -
published: boolean
Title:
PublishedRead Only:trueDefault Value:falseIndicates whether this article version is published. Default value is false for all versions other than the published version, if there is one. -
publishedContent:
publishedContent
-
publishedVersion: string
Title:
Published VersionRead Only:trueMaximum Length:50If this article has a published version in the requested locale, this fields will contain the version number of the published article version. -
rating:
rating
-
ratingsAggregate:
ratingsAggregate
-
recordId: string
Title:
Record IDRead Only:trueThe unique identifier of the article. This ID is the same in all versions in all locales of the article and is recommended for programmatic use. -
reviewInformation:
reviewInformation
-
schemaAttributes: array
Schema Attributes
Title:
Schema AttributesRead Only:trueReturns information about the schema of an article. -
title: string
Title:
TitleRead Only:trueMaximum Length:4000The title of the document. -
version: string
Title:
VersionRead Only:trueMaximum Length:50The version of the article. -
versionId: string
Title:
Version IDRead Only:trueMaximum Length:64The unique identifier of the specific version of an article in a specific locale. You cannot use this field in queries made using q query parameter. -
versionState: string
Title:
Version StateRead Only:trueThe state of a version, possible values are SCHEDULED, LIVE, EXPIRED, DRAFT. -
workflowStep:
workflowStep
arrayAll Translationstrue-
Array of:
object ContentDataBO
Documentation for BO mode: ContentDataBO
arrayAll Versionstrue-
Array of:
object ContentKeyBO
Documentation for BO mode: ContentKeyBO
The article status.
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+in+('DRAFT', 'WORK_IN_PROGRESS')http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT' and contentState eq 'LATEST'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+eq+'IM_NULL_ARTICLE_STATUS'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+in+('IM_NULL_ARTICLE_STATUS', 'DRAFT')
The service response matches any Content object (PUBLISHED by default) with article status specified in the request if you pass the articleStatus.refKey parameter.
Example URIs for the articleStatus parameter are as follows:
OR
The following example URIs returns Content objects whose contentState is LATEST:
The following example URI returns Content objects with no article status assigned:
The following example URI returns Content objects with no article status assigned and Content objects with the Draft article status assigned:
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
-
object
ArticleStatusKeyBO
Documentation for BO mode: ArticleStatusKeyBO
-
Title:
Article StatusThe article status.
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+in+('DRAFT', 'WORK_IN_PROGRESS')http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT' and contentState eq 'LATEST'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+eq+'IM_NULL_ARTICLE_STATUS'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+in+('IM_NULL_ARTICLE_STATUS', 'DRAFT')
The service response matches any Content object (PUBLISHED by default) with article status specified in the request if you pass the
articleStatus.refKeyparameter.Example URIs for the articleStatus parameter are as follows:
OR
The following example URIs returns Content objects whose contentState is LATEST:
The following example URI returns Content objects with no article status assigned:
The following example URI returns Content objects with no article status assigned and Content objects with the Draft article status assigned:
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
-
object
ContentAutosaveKeyBO
-
Title:
AutosaveRead Only:trueautosave record.
arrayAutosave Listtrue-
object
LocaleKeyBO
Documentation for BO mode: LocaleKeyBO:
Localized Name of the Locale is currently NOT provided (i.e. The word Japanese is always in Japanese and never localized in say Arabic.)
-
Title:
Based LocaleThe source locale used to create the localized version of the document. This field is seen only if the content has a localized version.
The user or author who performed the last content checkout. The following are the subfields that can be used with checkedOutBy query parameter:
- checkedOutBy.recordId : The unique identifier of the checkedOutBy object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=checkedOutBy.recordId eq '{id}' - checkedOutBy.email : User's email.
- checkedOutBy.firstName : User's firstName.
- checkedOutBy.lastName : User's lastName.
- checkedOutBy.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
Checked Out ByRead Only:trueThe user or author who performed the last content checkout. The following are the subfields that can be used with checkedOutBy query parameter:
- checkedOutBy.recordId : The unique identifier of the checkedOutBy object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=checkedOutBy.recordId eq '{id}' - checkedOutBy.email : User's email.
- checkedOutBy.firstName : User's firstName.
- checkedOutBy.lastName : User's lastName.
- checkedOutBy.login : User's login.
- checkedOutBy.recordId : The unique identifier of the checkedOutBy object. For example, to request an article with unique id, submit a call using the URI:
The channel to which the content is categorized and saved. The following are the subfields that can be used with contentType query parameter:
- contentType.recordId : The unique identifier of the ContentType object.
- contentType.referenceKey : The reference key for the ContentType object. ContentType objects support multiple languages. This field can be used to identify the associated objects for all languages. For Example to request articles for content type FAQ, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=contentType.referenceKey eq 'FAQ' - contentType.allowRecommendations : The flag indicates whether the content type allows end users to create recommendations for its contents. This also indicates whether you can associate the recommended content with a content type.
-
object
ContentTypeKeyBO
Documentation for BO mode: ContentTypeKeyBO
-
Title:
Content TypeThe channel to which the content is categorized and saved. The following are the subfields that can be used with contentType query parameter:
- contentType.recordId : The unique identifier of the ContentType object.
- contentType.referenceKey : The reference key for the ContentType object. ContentType objects support multiple languages. This field can be used to identify the associated objects for all languages. For Example to request articles for content type FAQ, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=contentType.referenceKey eq 'FAQ' - contentType.allowRecommendations : The flag indicates whether the content type allows end users to create recommendations for its contents. This also indicates whether you can associate the recommended content with a content type.
The user who originally authored or created the document. The following are the subfields that can be used with creator query parameter:
- creator.recordId : The unique identifier of the creator object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=creator.recordId eq '{id}' - creator.email : User's email.
- creator.firstName : User's firstName.
- creator.lastName : User's lastName.
- creator.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
CreatorRead Only:trueThe user who originally authored or created the document. The following are the subfields that can be used with creator query parameter:
- creator.recordId : The unique identifier of the creator object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=creator.recordId eq '{id}' - creator.email : User's email.
- creator.firstName : User's firstName.
- creator.lastName : User's lastName.
- creator.login : User's login.
- creator.recordId : The unique identifier of the creator object. For example, to request an article with unique id, submit a call using the URI:
objectContent External Associationstrue-
object ContentExternalAssociationBO
Documentation for ContentExternalAssociationBO
The user or author who performed the last content modification. The following are the subfields that can be used with lastModifier query parameter:
- lastModifier.recordId : The unique identifier of the lastModifier object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=lastModifier.recordId eq '{id}' - lastModifier.email : User's email.
- lastModifier.firstName : User's firstName.
- lastModifier.lastName : User's lastName.
- lastModifier.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
Last ModifierRead Only:trueThe user or author who performed the last content modification. The following are the subfields that can be used with lastModifier query parameter:
- lastModifier.recordId : The unique identifier of the lastModifier object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=lastModifier.recordId eq '{id}' - lastModifier.email : User's email.
- lastModifier.firstName : User's firstName.
- lastModifier.lastName : User's lastName.
- lastModifier.login : User's login.
- lastModifier.recordId : The unique identifier of the lastModifier object. For example, to request an article with unique id, submit a call using the URI:
-
object
ContentKeyBO
Documentation for BO mode: ContentKeyBO
-
Title:
Latest ContentRead Only:trueLatest BO for this document.
arrayLinkstrueThe locale of the version of the document. The locale code represents the language and country associated with the Locale object. The following subfield can be used with locale query parameter:
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=locale.recordId eq 'es_ES'
-
object
LocaleKeyBO
Documentation for BO mode: LocaleKeyBO:
Localized Name of the Locale is currently NOT provided (i.e. The word Japanese is always in Japanese and never localized in say Arabic.)
-
Title:
LocaleThe locale of the version of the document. The locale code represents the language and country associated with the Locale object. The following subfield can be used with locale query parameter:
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=locale.recordId eq 'es_ES'
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
The user or author who owns or is responsible for the document. The following are the subfields that can be used with owner query parameter:
- owner.recordId : The unique identifier of the owner object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=owner.recordId eq '{id}' - owner.email : User's email.
- owner.firstName : User's firstName.
- owner.lastName : User's lastName.
- owner.login : User's login.
-
object
UserKeyBO
Documentation for BO mode: UserKeyBO
-
Title:
OwnerRead Only:trueThe user or author who owns or is responsible for the document. The following are the subfields that can be used with owner query parameter:
- owner.recordId : The unique identifier of the owner object. For example, to request an article with unique id, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=owner.recordId eq '{id}' - owner.email : User's email.
- owner.firstName : User's firstName.
- owner.lastName : User's lastName.
- owner.login : User's login.
- owner.recordId : The unique identifier of the owner object. For example, to request an article with unique id, submit a call using the URI:
-
object
ContentKeyBO
Documentation for BO mode: ContentKeyBO
-
Title:
Published ContentRead Only:truePublished BO for this document.
- CUSTOM(0)
- YES(1)
- YES_NO(2)
- THREE_STARS(3)
- FIVE_STARS(4)
-
object
DataFormBO
Documentation for BO mode: DataFormBO
-
Title:
RatingRead Only:trueDetermined whether it is a 5 star or Y/N type of rating.- CUSTOM(0)
- YES(1)
- YES_NO(2)
- THREE_STARS(3)
- FIVE_STARS(4)
-
object
AggregateFormResultsBO
Documentation for BO mode: AggregateFormResultsBO
-
Title:
Ratings AggregateRead Only:trueThe aggregate form results. This includes the average rating, the total responses, and the specific rating values for this article.
-
object
ContentReviewInformationBO
Content Review Information BO
-
Title:
Review InformationRead Only:trueReview information added after document marked as reviewed.
arraySchema Attributestrue-
Array of:
object SchemaAttributeBO
Documentation for BO mode: SchemaAttributeBO
-
object
WorkflowStepDataBO
Documentation for BO mode: WorkflowStepDataBO
-
Title:
Workflow StepRead Only:trueThe step of the workflow in which the document version currently exist.
object-
allTranslations: array
All Translations
Title:
All TranslationsRead Only:trueContains a collection of translations available of an article, if there are any. -
allVersions: array
All Versions
Title:
All VersionsRead Only:trueContains a collection of all versions of an article. -
answerId: integer
(int64)
Title:
Answer IDRead Only:trueThe unique identifier of an article in a locale. -
articleStatus:
articleStatus
-
autoCheckIn: boolean
Title:
Auto Check InRead Only:trueDefault Value:falseIndicates whether the article needs to be automatically checked in after saving it. -
autosave:
autosave
-
autosaveList: array
Autosave List
Title:
Autosave ListRead Only:trueContains a collection of autosaves that exist for an article, if there are any. -
dateModified: string
(date)
Title:
Date ModifiedRead Only:trueThe date and time when this article was last modified. -
displayEndDate: string
(date)
Title:
Display End DateThe date and time when the article will stop being available to display to end-users. -
displayReviewDate: string
(date)
Title:
Display Review DateThe date and time when the article requires a review by an author capable of performing the review. -
displayStartDate: string
(date)
Title:
Display Start DateThe date and time when the article will be available to display to end-users.. -
documentId: string
Title:
Document IDRead Only:trueThe unique identifier of an article most usable for humans. -
externalAssociations: object
Content External Associations
Title:
Content External AssociationsRead Only:trueAdditional Properties Allowed: ContentExternalAssociationBOThis field will return external associations of content such as a reference to an SR this article was created from. -
latestContent:
latestContent
-
links: array
Links
Title:
LinksRead Only:trueREST API canonical and/or collection links for this Singular Resource -
locale(required):
locale
-
publishedContent:
publishedContent
-
rating:
rating
-
ratingsAggregate:
ratingsAggregate
-
recordId: string
Title:
Record IDRead Only:trueThe unique identifier of the article. This ID is the same in all versions in all locales of the article and is recommended for programmatic use. -
reviewInformation:
reviewInformation
-
schemaAttributes: array
Schema Attributes
Title:
Schema AttributesRead Only:trueReturns information about the schema of an article. -
title: string
Title:
TitleRead Only:trueMaximum Length:4000The title of the document. -
version: string
Title:
VersionRead Only:trueMaximum Length:50The version of the article. -
versionId: string
Title:
Version IDRead Only:trueMaximum Length:64The unique identifier of the specific version of an article in a specific locale. You cannot use this field in queries made using q query parameter. -
versionState: string
Title:
Version StateRead Only:trueThe state of a version, possible values are SCHEDULED, LIVE, EXPIRED, DRAFT.
arrayAll Translationstrue-
Array of:
object ContentDataBO
Documentation for BO mode: ContentDataBO
arrayAll Versionstrue-
Array of:
object ContentKeyBO
Documentation for BO mode: ContentKeyBO
The article status.
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+in+('DRAFT', 'WORK_IN_PROGRESS')http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT' and contentState eq 'LATEST'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+eq+'IM_NULL_ARTICLE_STATUS'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+in+('IM_NULL_ARTICLE_STATUS', 'DRAFT')
The service response matches any Content object (PUBLISHED by default) with article status specified in the request if you pass the articleStatus.refKey parameter.
Example URIs for the articleStatus parameter are as follows:
OR
The following example URIs returns Content objects whose contentState is LATEST:
The following example URI returns Content objects with no article status assigned:
The following example URI returns Content objects with no article status assigned and Content objects with the Draft article status assigned:
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
-
object
ArticleStatusKeyBO
Documentation for BO mode: ArticleStatusKeyBO
-
Title:
Article StatusThe article status.
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+in+('DRAFT', 'WORK_IN_PROGRESS')http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatus.referenceKey+eq+'DRAFT' and contentState eq 'LATEST'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+eq+'IM_NULL_ARTICLE_STATUS'http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=articleStatusRefKey+in+('IM_NULL_ARTICLE_STATUS', 'DRAFT')
The service response matches any Content object (PUBLISHED by default) with article status specified in the request if you pass the
articleStatus.refKeyparameter.Example URIs for the articleStatus parameter are as follows:
OR
The following example URIs returns Content objects whose contentState is LATEST:
The following example URI returns Content objects with no article status assigned:
The following example URI returns Content objects with no article status assigned and Content objects with the Draft article status assigned:
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
If there is no Content object that matches specified articleStatus query, response will include status of 200 OK with no records.
-
object
ContentAutosaveKeyBO
-
Title:
AutosaveRead Only:trueautosave record.
arrayAutosave ListtrueobjectContent External Associationstrue-
object ContentExternalAssociationBO
Documentation for ContentExternalAssociationBO
-
object
ContentKeyBO
Documentation for BO mode: ContentKeyBO
-
Title:
Latest ContentRead Only:trueLatest BO for this document.
arrayLinkstrueThe locale of the version of the document. The locale code represents the language and country associated with the Locale object. The following subfield can be used with locale query parameter:
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=locale.recordId eq 'es_ES'
-
object
LocaleKeyBO
Documentation for BO mode: LocaleKeyBO:
Localized Name of the Locale is currently NOT provided (i.e. The word Japanese is always in Japanese and never localized in say Arabic.)
-
Title:
LocaleThe locale of the version of the document. The locale code represents the language and country associated with the Locale object. The following subfield can be used with locale query parameter:
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
http://${pageContext.request.serverName}:${pageContext.request.serverPort}${pageContext.request.contextPath}/api/content?q=locale.recordId eq 'es_ES'
- locale.recordId : The unique identifier of the Locale object. For example, to request an article in the Spanish-Spain locale, submit a call using the URI:
-
object
ContentKeyBO
Documentation for BO mode: ContentKeyBO
-
Title:
Published ContentRead Only:truePublished BO for this document.
- CUSTOM(0)
- YES(1)
- YES_NO(2)
- THREE_STARS(3)
- FIVE_STARS(4)
-
object
DataFormBO
Documentation for BO mode: DataFormBO
-
Title:
RatingRead Only:trueDetermined whether it is a 5 star or Y/N type of rating.- CUSTOM(0)
- YES(1)
- YES_NO(2)
- THREE_STARS(3)
- FIVE_STARS(4)
-
object
AggregateFormResultsBO
Documentation for BO mode: AggregateFormResultsBO
-
Title:
Ratings AggregateRead Only:trueThe aggregate form results. This includes the average rating, the total responses, and the specific rating values for this article.
-
object
ContentReviewInformationBO
Content Review Information BO
-
Title:
Review InformationRead Only:trueReview information added after document marked as reviewed.
arraySchema Attributestrue-
Array of:
object SchemaAttributeBO
Documentation for BO mode: SchemaAttributeBO
object-
links: array
Links
Title:
LinksRead Only:trueThe collection links related to this resource -
name: string
Title:
NameRead Only:trueMinimum Length:1Maximum Length:255The localized name of the ArticleStatus object. The name field can only be used for sorting. -
recordId: string
Title:
Record IdThe unique identifier of the ArticleStatus object. -
referenceKey: string
Title:
Reference KeyMaximum Length:255The reference key for the ArticleStatus object. ArticleStatus objects support multiple languages. This field can be used to identify the associated objects for all languages.
arrayLinkstrueobject-
autosaveType(required):
autosaveType
-
dateAdded: string
(date)
Title:
Date AddedRead Only:trueThe date and time when this autosave was created. -
dateModified: string
(date)
Title:
Date ModifiedRead Only:trueThe date and time this autosave was last modified. -
documentId: string
Title:
Document IdRead Only:trueThe unique identifier of a document that indicates the content type in which the content is saved. -
locale: object
LocaleKeyBO
Documentation for BO mode: LocaleKeyBO:
Localized Name of the Locale is currently NOT provided (i.e. The word Japanese is always in Japanese and never localized in say Arabic.)
-
recordId: string
-
title: string
Maximum Length:
4000
-
string
Allowed Values:
[ "ALL", "CREATED", "EDITED", "TRANSLATED" ] -
objectLocalized Name of the Locale is currently NOT provided (i.e. The word Japanese is always in Japanese and never localized in say Arabic.)
-
links: array
Links
Title:
LinksRead Only:trueREST API canonical and/or collection links for this Singular Resource -
localeDesc: string
Title:
Locale DescRead Only:trueMaximum Length:100The description about the language and country that the Locale object represents. -
recordId: string
Title:
Record IdThe unique identifier of the Locale object.
arrayLinkstrueobject-
alternateId: string
Title:
Alternate IdThe alternate identifier of the external association -
alternateIdType: string
Title:
Alternate Id TypeThe alternate type of the external assocation -
objectId(required): string
Title:
Object IdMinimum Length:1Maximum Length:50The unique identifier of the external association. -
properties: object
Properties
Title:
PropertiesAdditional Properties Allowed: additionalPropertiesThe properties of the external association -
type(required): string
Title:
Object TypeMinimum Length:1Maximum Length:100The type of the external association
objectPropertiesobject-
dateAdded(required): string
(date)
Title:
Date AddedRead Only:trueThe date and time when this DataForm object was created. -
dateModified(required): string
(date)
Title:
Date ModifiedRead Only:trueThe date and time when this DataForm object was last modified. -
displayEndDate: string
(date)
Title:
Display End DateThe date when the service stops the display of the data form to the end users -
displayStartDate: string
(date)
Title:
Display Start DateThe date when the data form will be available to display to end-users -
emailContent: boolean
Title:
Email ContentThe emailContent field of the DataForm object -
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
name: string
Title:
NameMaximum Length:255The name of the data form. The name field can only be used for sorting. -
questions: array
Questions
Title:
QuestionsTo Many Relationship to Question -
ratingType: integer
(int32)
Title:
Rating TypeDetermined whether it is a 5 star or Y/N type of rating- CUSTOM(0)
- YES(1)
- YES_NO(2)
- THREE_STARS(3)
- FIVE_STARS(4)
-
recordId(required): string
Title:
Record IdRead Only:trueThe unique identifier of the DataForm object -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:255The reference key for the DataForm object -
user:
user
-
views: array
Views
Title:
ViewsTo Many Relationship to View
arrayLinksarrayQuestions-
Array of:
object DataFormQuestionBO
Documentation for BO mode: QuestionBO
arrayViews-
Array of:
object ViewKeyBO
Documentation for BO mode: ViewKeyBO
object-
answers: array
Answers
Title:
AnswersTo Many Relationship to Answer -
dataForm:
dataForm
-
dateAdded(required): string
(date)
Title:
Date AddedRead Only:trueThe date and time the DataFormQuestion object was created -
dateModified(required): string
(date)
Title:
Date ModifiedRead Only:trueThe date and time the DataFormQuestion object was last modified -
isMasterIdentifier: boolean
Title:
Is Master IdentifierThe isMasterIdentifier field of the DataFormQuestion object -
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
name(required): string
Title:
NameMinimum Length:1Maximum Length:255The localized name of the DataFormQuestion object -
recordId(required): string
Title:
Record IdRead Only:trueThe unique identifier of the DataFormQuestion object -
referenceKey: string
Title:
Reference KeyMaximum Length:255The reference key for the DataFormQuestion object -
required: boolean
Title:
RequiredThe flag that indicates whether or not this question is required -
sortOrder: integer
(int32)
Title:
Sort OrderThe sort order of this question -
specialTypeIndicator: integer
(int32)
Title:
Special Type IndicatorThe specialTypeIndicator field of the DataFormQuestion object
arrayAnswers-
Array of:
object DataFormAnswerBO
Documentation for BO mode: AnswerBO
-
object
DataFormKeyBO
Documentation for BO mode: DataFormKeyBO
-
Title:
Data FormRelationship to Rating
arrayLinksobject-
dataFormQuestion:
dataFormQuestion
-
dateAdded(required): string
(date)
Title:
Date AddedRead Only:trueThe date and time when this DataFormAnswer object was created. -
dateModified(required): string
(date)
Title:
Date ModifiedRead Only:trueThe date and time when this DataFormAnswer object was last modified. -
defaultAnswer: boolean
Title:
Default AnswerThe flag that indicates whether or not this answer is the default answer -
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
name(required): string
Title:
NameMinimum Length:1Maximum Length:255The localized name of the DataFormAnswer object -
numberValue: integer
(int32)
Title:
Number ValueThe numeric value of the answer -
recordId(required): string
Title:
Record IdRead Only:trueThe unique identifier of the DataFormAnswer object -
referenceKey: string
Title:
Reference KeyMaximum Length:255The reference key for the DataFormAnswer object -
sortOrder: integer
(int32)
Title:
Sort OrderThe sort order of the answer
-
object
DataFormQuestionKeyBO
Documentation for BO mode: QuestionKeyBO
-
Title:
Data Form QuestionRelationship to Question
arrayLinksobject-
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
recordId(required): string
Title:
Record IdRead Only:trueThe unique identifier of the DataFormQuestion object -
referenceKey: string
Title:
Reference KeyMaximum Length:255The reference key for the DataFormQuestion object
arrayLinksobject-
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
recordId(required): string
Title:
Record IdRead Only:trueThe unique identifier of the DataForm object -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:255The reference key for the DataForm object
arrayLinksobject-
canAssignTask: boolean
Title:
Can Assign tasksReturns whether this user can assign tasks to other users. -
contentTypePrivileges: array
Content Type Privileges
Title:
Content Type PrivilegesThis field will return list of all contenttype privileges user have -
email: string
Title:
EmailMaximum Length:100The user's e-mail address -
externalId: integer
(int64)
Title:
External IdRead Only:trueThe ExternalId is the Id of the corresponding User from an external system. It, along with ExternalType, can be used to bridge the gap between a User from this system and a User from an external system. -
functionalPrivileges: object
Functional Privileges of user
Title:
Functional Privileges of userAdditional Properties Allowed: additionalPropertiesThis field will return list of all fucntional privileges user have -
links: array
Links
Title:
LinksRead Only:trueREST API canonical and/or collection links for this Singular Resource -
login: string
Title:
LoginMaximum Length:100The user's login -
name: string
Title:
NameRead Only:trueMaximum Length:100User's full name -
recordId(required): integer
(int64)
Title:
Record IdRead Only:trueThe unique identifier of the user
arrayContent Type Privileges-
Array of:
object CompositeContentTypeBO
Composite of ContentTypeBO and its flattened relation. Keep in mind we can add more stuff down the line
objectFunctional Privileges of user arrayLinkstrueobject-
compositeWorkflowSteps(required): array
WorkflowSteps Composite BO
Title:
WorkflowSteps Composite BOWorkflowSteps mapped to this content type and user privileges on that -
contentTypeKeyBO(required):
contentTypeKeyBO
-
hasContentTypeAccess: boolean
Title:
Has Content Type AccessVerifies if ContentTypeBO privileges are valid for user -
listOfPrivilege(required): array
List Of Privilege
Title:
List Of PrivilegeList of Privileges for the ContentType
arrayWorkflowSteps Composite BO-
Array of:
object CompositeWorkflowStepBO
Composite of WorkflowStepBO with user privileges on this step.
-
object
ContentTypeKeyBO
Documentation for BO mode: ContentTypeKeyBO
-
Title:
Content Type Key BOContentBO object being created or updated
arrayList Of Privilegeobject-
listOfPrivilege(required): array
List Of Privilege
Title:
List Of PrivilegeList of Privileges for the WorkflowStep -
WorkflowStepKeyBO(required):
WorkflowStepKeyBO
arrayList Of Privilege-
object
WorkflowStepKeyBO
Documentation for BO mode: WorkflowStepKeyBO
-
Title:
WorkflowStep Key BOWorkflowStep object being fetched
object-
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
name: string
Title:
NameMaximum Length:255Localized name of the workflow step -
recordId(required): string
Title:
Record IdRead Only:trueGUID from the WORKFLOWSTEP table -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:100Non localized name of the workflow step -
workflowId(required): string
Title:
WorkflowRecord IdRead Only:trueGUID from the WORKFLOW table
arrayLinksobject-
description: string
Title:
DescriptionMaximum Length:255The description for the ContentType object. Content Types support multiple languages. This field identifies the object associated with the language specified by the user. -
links: array
Links
Title:
LinksRead Only:trueREST API canonical and/or collection links for this Singular Resource -
name(required): string
Title:
NameMinimum Length:1Maximum Length:255The name for the ContentType object. The name field can only be used for sorting. Content Types support multiple languages. This field identifies the object associated with the language specified by the user. -
recordId: string
Title:
Record IdRead Only:trueThe unique identifier of the ContentType object. -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:255The reference key for the ContentType object. ContentType objects support multiple languages. This field can be used to identify the associated objects for all languages. -
stripeCd(required): string
Title:
Stripe CdMaximum Length:30Lookup code that indicates the stripe code. -
usageCode: string
Title:
Usage CodeRead Only:trueMaximum Length:30Lookup code that indicates the product usage code. -
workflow:
workflow
arrayLinkstrue-
object
WorkflowKeyBO
-
Title:
WorkflowThe workflow definition that the author can use while content authoring in a content type.
object-
enabled: boolean
-
links: array
links
-
name: string
Maximum Length:
255 -
recordId: string
-
referenceKey: string
Minimum Length:
0Maximum Length:100 -
workflowVersion: integer
(int32)
object-
links: array
Links
Title:
LinksRead Only:trueREST API canonical and/or collection links for this Singular Resource -
name: string
Title:
NameMaximum Length:255Localized name of the view -
recordId(required): string
Title:
Record IdRead Only:trueGUID of the SITE table containing the view definition -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:255Non localized reference key for the view -
stripeCd: string
Title:
Stripe CDMaximum Length:30Stripe of a view
arrayLinkstrueobject-
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
questions: array
Questions
Title:
QuestionsTo Many Relationship to AggregateQuestionResult -
recordId(required): string
Title:
Record IdRead Only:trueThe unique record ID of the AggregateFormResults object. -
referenceKey: string
Title:
Reference KeyMaximum Length:255The reference key for the AggregateFormResults object. AggregateFormResults objects support multiple languages. This field can be used to identify the associated objects for all languages. -
totalResponses: integer
(int64)
Title:
Total ResponsesTotalResponses of the AggregateFormResults object
arrayLinksarrayQuestions-
Array of:
object AggregateQuestionResultBO
Documentation for BO mode: AggregateQuestionResultBO
object-
answers: array
Answers
Title:
AnswersTo Many Relationship to AggregateAnswerResult -
averageResponse: number
(double)
Title:
Average ResponseAverageResponse of the AggregateQuestionResult object -
name(required): string
Title:
NameMinimum Length:1Maximum Length:255Localized display name for the Question -
recordId(required): string
Title:
Record IdRead Only:trueThe unique record ID of the AggregateQuestionResult object. -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:255The reference key for the AggregateQuestionResult object. AggregateQuestionResult objects support multiple languages. This field can be used to identify the associated objects for all languages. -
totalResponses: integer
(int64)
Title:
Total ResponsesTotalResponses of the AggregateQuestionResult object
arrayAnswers-
Array of:
object AggregateAnswerResultBO
Documentation for BO mode: AggregateAnswerResultBO
object-
name(required): string
Title:
NameMinimum Length:1Maximum Length:255Localized display name for the Answer -
recordId(required): string
Title:
Record IdRead Only:trueThe unique record ID of the AggregateAnswerResult object. -
referenceKey: string
Title:
Reference KeyMaximum Length:255The reference key for the AggregateAnswerResult object. AggregateAnswerResult objects support multiple languages. This field can be used to identify the associated objects for all languages. -
totalResponses: integer
(int64)
Title:
Total ResponsesTotalResponses of the AggregateAnswerResult object
object-
lastUpdateDate: string
(date)
Title:
Last Update DateRead Only:trueThe date when the document was marked reviewed. -
lastUpdatedBy:
lastUpdatedBy
-
state:
state
-
string
Allowed Values:
[ "REVIEWED" ] -
Title:
StateRead Only:truereview state for document.
object-
allowMultipleNodes: boolean
Title:
Allow Multiple NodesFlag indicating if multiple nodes are allowed of this type@since 8.3 -
allowPreselectedUserGroupChange: boolean
Title:
Allow Preselected User Group ChangeEnable editors to modify preselected user group restrictions@since 8.3 -
children: array
Children
Title:
ChildrenList of child nodes of the current element -
counter: integer
(int32)
Title:
CounterThis attribute contains the current value of the ContentType DOC ID counter. This value should not be changed after content is added to the ContentType -
counterPrefix: string
Title:
Counter PrefixMaximum Length:50This attribute contains the prefix that is appended to the front of the DOC ID counter -
dateAdded: string
(date)
Title:
Date AddedRead Only:trueThe date and time when this SchemaAttribute definition was first created -
dateModified: string
(date)
Title:
Date ModifiedRead Only:trueThe date and time when this SchemaAttribute definition was last modified -
description: string
Title:
DescriptionMaximum Length:1000Localized help text for the attribute. This text is displayed in the authoring view -
enableAttributeLevelSearch: boolean
Title:
Enable Attribute Level SearchFlag indicating whether this field should be configured for attribute level searching - i.e. where TITLE='xyz'. This fieldwas previously called searchable@since 8.3 -
enableFullTextSearch: boolean
Title:
Enable Full Text SearchFlag indicating whether this field should be included in the full text index. This field was previouslycalled indexable@since 8.3 -
includeInMasterIdentifier: boolean
Title:
Include In Master IdentifierFlag indicating whether this field should be appended to the master identifier of the document -
isNode: boolean
Title:
Is NodeFlag indicating if this element is a node@since 8.3 -
isRequired: boolean
Title:
Is RequiredMake attribute a required field@since 8.3 -
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
localizedAttributes: array
Localized Attributes
Title:
Localized AttributesList of LocalizedAttributes of this SchemaAttribute name and description in various Locales -
name(required): string
Title:
NameMinimum Length:1Maximum Length:255Localized name of the attribute. This need NOT be unique within the Schema. -
readOnly: boolean
Title:
Read OnlyFlag indicating whether this field is editable -
recordId: string
Title:
Record IdRead Only:trueUnique identifier for the SchemaAttribute object -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:100Non localized name of the attribute.SchemaAttribute's referenceKey need NOT be unique within its Schema.But its xpath will be unique within its Schema. -
requireWorkflowApproval: boolean
Title:
Require Workflow ApprovalAttribute requires workflow approval if workflow is enabled -
schemaAttributeUserGroupList: array
Schema Attribute User Group List
Title:
Schema Attribute User Group ListList of user groups that can be used to secure this attribute. This should be a subset of the list of user groups assigned to the ContentType -
schemaAttrType:
schemaAttrType
-
securedFileResource: boolean
Title:
Secured File ResourceFlag indicating if this attribute (file types only) should be marked as secure - i.e. stored in the ~secure folder near the content XML file -
secureWithUserGroups: boolean
Title:
Secure With User GroupsRestrict attribute to selected user groups -
securityRegex: string
Title:
Security RegexMaximum Length:100The regular expression used to validate the field against security attacks. -
sortOrder: integer
(int32)
Title:
Sort OrderDisplay order of the schema attributes within the edit form -
textHeight: string
Title:
Text HeightMaximum Length:10Specifies the text height for text areas and rich text fields -
textWidth: string
Title:
Text WidthMaximum Length:10Specifies the max length for text fields -
userGroupSelectionRequired: boolean
Title:
User Group Selection RequiredUser groups are required for attribute -
wysiwygType:
wysiwygType
-
xpath: string
Title:
XpathMaximum Length:2000The XPATH of this attribute within the schema. This is unique within the Schema.
arrayChildren-
Array of:
object SchemaAttributeBO
Documentation for BO mode: SchemaAttributeBO
arrayLinksarrayLocalized AttributesarraySchema Attribute User Group List-
string
Allowed Values:
[ "BOOLEAN", "COUNTER", "DATE", "DATETIME", "FILE", "FLOAT", "INTEGER", "LIST", "TEXT_AREA", "TEXT_FIELD", "TIME", "WYSIWYG_EDIT" ] -
Title:
Schema Attr TypeEnumerated type representing the type of attribute - i.e. text field, rich text area
-
string
Allowed Values:
[ "BASIC", "FULL", "MEDIUM" ] -
Title:
Wysiwyg TypeType of WYSIWYG rich text field - i.e. FULL, BASIC, MEDIUM@since 8.3
object-
description: string
Title:
DescriptionMaximum Length:1000Localized description in the above Locale -
localeId(required): string
Title:
Locale IdRead Only:trueRecordId of the Locale - generally this is the localeCode (like en_US) and NOT a real GUID. -
name(required): string
Title:
NameMinimum Length:1Maximum Length:255Localized Name in the above Locale
object-
defaultValue: boolean
-
recordId: string
-
userGroup: object
UserGroupKeyBO
Documentation for BO mode: UserGroupKeyBO
object-
links: array
Links
Title:
LinksRead Only:trueThe collection links related to this resource -
name: string
Title:
NameRead Only:trueMaximum Length:255The localized name of the user group. The name field can only be used for sorting. -
recordId: string
Title:
Record IdThe unique identifier from the TAG table that represent a userGroups resource -
referenceKey: string
Title:
Reference KeyMaximum Length:255The non localized name of the user group -
stripeCd: string
Title:
Stripe CDRead Only:trueMaximum Length:30Stripe for UserGroup
arrayLinkstrueobject-
allowDocumentEditing: boolean
Title:
Allow Document EditingFlag indicating whether this step allows document editing -
dateAdded(required): string
(date)
Title:
Date AddedRead Only:trueThe date and time when this work flow step was added. -
dateModified(required): string
(date)
Title:
Date ModifiedRead Only:trueThe date and time when this work flow step was last modified. -
defaultStepDurationInMinutes: integer
(int32)
Title:
Default Workflow Step Due date in minutesTime in minutes that the workflow step task will stay in queue before being consdiered overdue -
links: array
Links
Title:
LinksREST API canonical and/or collection links for this Singular Resource -
name: string
Title:
NameMaximum Length:255Localized name of the workflow step -
onlyAssigneeCanAppove: boolean
Title:
Can only assignee approve stepFlag indicating whether this step can only be approved by workflow step task assignee -
recordId(required): string
Title:
Record IdRead Only:trueGUID from the WORKFLOWSTEP table -
referenceKey(required): string
Title:
Reference KeyMinimum Length:1Maximum Length:100Non localized name of the workflow step -
sortOrder: integer
(int32)
Title:
Sort OrderThe order of the workflow steps within the workflow -
workflowId(required): string
Title:
WorkflowRecord IdRead Only:trueGUID from the WORKFLOW table
arrayLinksobject-
categoryId(required): integer
(int64)
Title:
Category IdThe unique identifier of the category.
object-
inventoryItemId: integer
(int64)
Title:
Inventory Item IdThe unique identifier of the product. -
organizationId: integer
(int64)
Title:
Organization IdThe inventory organization id of the specific category. -
productGroupId: integer
(int64)
Title:
Product Group IdThe unique identifier of the product group.
object-
externalAssociations: object
Content External Associations
Title:
Content External AssociationsRead Only:trueAdditional Properties Allowed: ContentExternalAssociationBOThis field will return external associations of content. -
operation: string
Title:
OperationThe action this metadata is providing context for. -
sourceDocId: string
Title:
Source Doc IdRead Only:truedocId of the article being copied. -
sourceLocaleId: string
Title:
Source Locale IdRead Only:trueThe locale of the article being copied or reverted to. -
sourceVersion: string
Title:
Source VersionRead Only:trueThe version of the article being copied or reverted to. -
sourceVersionId: string
Title:
Source Version IdThe versionId of the acticle being copied.
objectContent External Associationstrue-
object ContentExternalAssociationBO
Documentation for ContentExternalAssociationBO