Get all knowledge articles
/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
-
langpref: string
his parameter filters the returned items based on locale. If used, this parameter will take precedence over Accept-Language.Example:
fr_FR
-
limit: integer
Minimum Value:
1
Maximum Value:1000
This parameter restricts the number of items returned per page. If the limit exceeds the available items then all are returned. The maximum value is 1000.Default Value:20
-
offset: integer
Minimum Value:
0
Used for pagination, this parameter indicates the starting point in the collection, for example. if you are returning 10 per page, have 100 items, and want to return the second page you would use limit=10&offset=10. If offset exceeds the resource count then no resources are returned. Default value is 0.Default Value:0
-
onlyData: boolean
Prevents links from being returned in the response, defaults to false.Default Value:
false
-
orderBy: string
This parameter orders items returned based on the specified fields. The parameter value is a comma-separated string of attribute names, each optionally followed by a colon and "asc" or "desc". Specify "asc" for ascending and "desc" for descending. The default value is "asc".Example:
field1:asc,field2:desc
-
q: string
Used to filter the items in your response. The available attribute/parameter combinations and usage instructions can be found in Reference > Supported Query Parameters.
-
totalResults: boolean
Causes the response to include an "estimated row count" when "?totalResults=true", otherwise this count is not included. The default value is "false". It is recommended to only use this as part of the request for your first page of results.Default Value:
false
There's no request body for this operation.
Back to TopResponse
- application/json
200 Response
object
-
count: integer
(int32)
-
hasMore(required): boolean
Title:
Has More
Default Value:false
Boolean indicating whether or not the collection contains more items than were returned in this request. Defaults to false. -
items(required): array
Items
Title:
Items
The collection of of the requested resources meeting your criteria. -
limit(required): integer
(int32)
Title:
Limit
The number of items this result is limited to. Used in conjunction with offset for pagination. -
links: array
Links
Title:
Links
REST API canonical and/or collection links for this Singular Resource -
offset(required): integer
(int32)
Title:
Offset
The item index at which this resultset starts. Used in conjunction with limit for pagination. -
totalResults: integer
(int64)
Title:
Total Results
The number of available items that meet the criteria used. This attribute must be explicitly requested by adding totalResults=true to the querystring.
array
Items
-
Array of:
object ContentDataBO
Documentation for BO mode: ContentDataBO
array
Links
object
-
allTranslations: array
All Translations
Title:
All Translations
Read Only:true
Contains a collection of translations available of an article, if there are any. -
allVersions: array
All Versions
Title:
All Versions
Read Only:true
Contains a collection of all versions of an article. -
answerId: integer
(int64)
Title:
Answer ID
Read Only:true
The unique identifier of an article in a locale. -
articleStatus:
articleStatus
-
autoCheckIn: boolean
Title:
Auto Check In
Read Only:true
Default Value:false
Indicates whether the article needs to be automatically checked in after saving it. -
autosave:
autosave
-
autosaveList: array
Autosave List
Title:
Autosave List
Read Only:true
Contains a collection of autosaves that exist for an article, if there are any. -
basedLocale:
basedLocale
-
basedOnVersion: string
Title:
Based On Version
Read Only:true
Maximum Length:50
If this article version is a localization, this field may contain the version of the article the localization was created from. -
checkedOut: boolean
Title:
Checked Out
Read Only:true
Default Value:false
The 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 Date
Read Only:true
The date and time when this article was originally created. -
creator:
creator
-
dateAdded: string
(date)
Title:
Date Added
Read Only:true
The date and time when this article version was created. -
dateModified: string
(date)
Title:
Date Modified
Read Only:true
The date and time when this article was last modified. -
displayEndDate: string
(date)
Title:
Display End Date
The date and time when the article will stop being available to display to end-users. -
displayReviewDate: string
(date)
Title:
Display Review Date
The date and time when the article requires a review by an author capable of performing the review. -
displayStartDate: string
(date)
Title:
Display Start Date
The date and time when the article will be available to display to end-users.. -
documentId: string
Title:
Document ID
Read Only:true
The unique identifier of an article most usable for humans. -
externalAssociations: object
Content External Associations
Title:
Content External Associations
Read Only:true
Additional 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 Date
Read Only:true
The date and time when this article was last modified. -
lastModifier:
lastModifier
-
latestContent:
latestContent
-
links: array
Links
Title:
Links
Read Only:true
REST API canonical and/or collection links for this Singular Resource -
locale(required):
locale
-
owner:
owner
-
pending: boolean
Title:
Pending
Read Only:true
Default Value:false
Indicates 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 Date
Read Only:true
The date and time when this article version was published. -
published: boolean
Title:
Published
Read Only:true
Default Value:false
Indicates 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 Version
Read Only:true
Maximum Length:50
If 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 ID
Read Only:true
The 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 Attributes
Read Only:true
Returns information about the schema of an article. -
title: string
Title:
Title
Read Only:true
Maximum Length:4000
The title of the document. -
version: string
Title:
Version
Read Only:true
Maximum Length:50
The version of the article. -
versionId: string
Title:
Version ID
Read Only:true
Maximum Length:64
The 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 State
Read Only:true
The state of a version, possible values are SCHEDULED, LIVE, EXPIRED, DRAFT. -
workflowStep:
workflowStep
array
All Translations
true
-
Array of:
object ContentDataBO
Documentation for BO mode: ContentDataBO
array
All Versions
true
-
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 Status
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
ContentAutosaveKeyBO
-
Title:
Autosave
Read Only:true
autosave record.
array
Autosave List
true
-
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 Locale
The 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 By
Read Only:true
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.
- 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 Type
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.
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:
Creator
Read Only:true
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.
- creator.recordId : The unique identifier of the creator object. For example, to request an article with unique id, submit a call using the URI:
object
Content External Associations
true
-
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 Modifier
Read Only:true
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.
- 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 Content
Read Only:true
Latest BO for this document.
array
Links
true
The 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:
Locale
The 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:
Owner
Read Only:true
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.
- 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 Content
Read Only:true
Published 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:
Rating
Read Only:true
Determined 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 Aggregate
Read Only:true
The 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 Information
Read Only:true
Review information added after document marked as reviewed.
array
Schema Attributes
true
-
Array of:
object SchemaAttributeBO
Documentation for BO mode: SchemaAttributeBO
-
object
WorkflowStepDataBO
Documentation for BO mode: WorkflowStepDataBO
-
Title:
Workflow Step
Read Only:true
The step of the workflow in which the document version currently exist.
object
-
allTranslations: array
All Translations
Title:
All Translations
Read Only:true
Contains a collection of translations available of an article, if there are any. -
allVersions: array
All Versions
Title:
All Versions
Read Only:true
Contains a collection of all versions of an article. -
answerId: integer
(int64)
Title:
Answer ID
Read Only:true
The unique identifier of an article in a locale. -
articleStatus:
articleStatus
-
autoCheckIn: boolean
Title:
Auto Check In
Read Only:true
Default Value:false
Indicates whether the article needs to be automatically checked in after saving it. -
autosave:
autosave
-
autosaveList: array
Autosave List
Title:
Autosave List
Read Only:true
Contains a collection of autosaves that exist for an article, if there are any. -
dateModified: string
(date)
Title:
Date Modified
Read Only:true
The date and time when this article was last modified. -
displayEndDate: string
(date)
Title:
Display End Date
The date and time when the article will stop being available to display to end-users. -
displayReviewDate: string
(date)
Title:
Display Review Date
The date and time when the article requires a review by an author capable of performing the review. -
displayStartDate: string
(date)
Title:
Display Start Date
The date and time when the article will be available to display to end-users.. -
documentId: string
Title:
Document ID
Read Only:true
The unique identifier of an article most usable for humans. -
externalAssociations: object
Content External Associations
Title:
Content External Associations
Read Only:true
Additional 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:
Links
Read Only:true
REST API canonical and/or collection links for this Singular Resource -
locale(required):
locale
-
publishedContent:
publishedContent
-
rating:
rating
-
ratingsAggregate:
ratingsAggregate
-
recordId: string
Title:
Record ID
Read Only:true
The 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 Attributes
Read Only:true
Returns information about the schema of an article. -
title: string
Title:
Title
Read Only:true
Maximum Length:4000
The title of the document. -
version: string
Title:
Version
Read Only:true
Maximum Length:50
The version of the article. -
versionId: string
Title:
Version ID
Read Only:true
Maximum Length:64
The 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 State
Read Only:true
The state of a version, possible values are SCHEDULED, LIVE, EXPIRED, DRAFT.
array
All Translations
true
-
Array of:
object ContentDataBO
Documentation for BO mode: ContentDataBO
array
All Versions
true
-
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 Status
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
ContentAutosaveKeyBO
-
Title:
Autosave
Read Only:true
autosave record.
array
Autosave List
true
object
Content External Associations
true
-
object ContentExternalAssociationBO
Documentation for ContentExternalAssociationBO
-
object
ContentKeyBO
Documentation for BO mode: ContentKeyBO
-
Title:
Latest Content
Read Only:true
Latest BO for this document.
array
Links
true
The 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:
Locale
The 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 Content
Read Only:true
Published 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:
Rating
Read Only:true
Determined 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 Aggregate
Read Only:true
The 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 Information
Read Only:true
Review information added after document marked as reviewed.
array
Schema Attributes
true
-
Array of:
object SchemaAttributeBO
Documentation for BO mode: SchemaAttributeBO
object
-
links: array
Links
Title:
Links
Read Only:true
The collection links related to this resource -
name: string
Title:
Name
Read Only:true
Minimum Length:1
Maximum Length:255
The localized name of the ArticleStatus object. The name field can only be used for sorting. -
recordId: string
Title:
Record Id
The unique identifier of the ArticleStatus object. -
referenceKey: string
Title:
Reference Key
Maximum Length:255
The reference key for the ArticleStatus object. ArticleStatus objects support multiple languages. This field can be used to identify the associated objects for all languages.
array
Links
true
object
-
autosaveType(required):
autosaveType
-
dateAdded: string
(date)
Title:
Date Added
Read Only:true
The date and time when this autosave was created. -
dateModified: string
(date)
Title:
Date Modified
Read Only:true
The date and time this autosave was last modified. -
documentId: string
Title:
Document Id
Read Only:true
The 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" ]
-
object
Localized 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:
Links
Read Only:true
REST API canonical and/or collection links for this Singular Resource -
localeDesc: string
Title:
Locale Desc
Read Only:true
Maximum Length:100
The description about the language and country that the Locale object represents. -
recordId: string
Title:
Record Id
The unique identifier of the Locale object.
array
Links
true
object
-
alternateId: string
Title:
Alternate Id
The alternate identifier of the external association -
alternateIdType: string
Title:
Alternate Id Type
The alternate type of the external assocation -
objectId(required): string
Title:
Object Id
Minimum Length:1
Maximum Length:50
The unique identifier of the external association. -
properties: object
Properties
Title:
Properties
Additional Properties Allowed: additionalPropertiesThe properties of the external association -
type(required): string
Title:
Object Type
Minimum Length:1
Maximum Length:100
The type of the external association
object
Properties
object
-
dateAdded(required): string
(date)
Title:
Date Added
Read Only:true
The date and time when this DataForm object was created. -
dateModified(required): string
(date)
Title:
Date Modified
Read Only:true
The date and time when this DataForm object was last modified. -
displayEndDate: string
(date)
Title:
Display End Date
The date when the service stops the display of the data form to the end users -
displayStartDate: string
(date)
Title:
Display Start Date
The date when the data form will be available to display to end-users -
emailContent: boolean
Title:
Email Content
The emailContent field of the DataForm object -
links: array
Links
Title:
Links
REST API canonical and/or collection links for this Singular Resource -
name: string
Title:
Name
Maximum Length:255
The name of the data form. The name field can only be used for sorting. -
questions: array
Questions
Title:
Questions
To Many Relationship to Question -
ratingType: integer
(int32)
Title:
Rating Type
Determined 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 Id
Read Only:true
The unique identifier of the DataForm object -
referenceKey(required): string
Title:
Reference Key
Minimum Length:1
Maximum Length:255
The reference key for the DataForm object -
user:
user
-
views: array
Views
Title:
Views
To Many Relationship to View
array
Links
array
Questions
-
Array of:
object DataFormQuestionBO
Documentation for BO mode: QuestionBO
array
Views
-
Array of:
object ViewKeyBO
Documentation for BO mode: ViewKeyBO
object
-
answers: array
Answers
Title:
Answers
To Many Relationship to Answer -
dataForm:
dataForm
-
dateAdded(required): string
(date)
Title:
Date Added
Read Only:true
The date and time the DataFormQuestion object was created -
dateModified(required): string
(date)
Title:
Date Modified
Read Only:true
The date and time the DataFormQuestion object was last modified -
isMasterIdentifier: boolean
Title:
Is Master Identifier
The isMasterIdentifier field of the DataFormQuestion object -
links: array
Links
Title:
Links
REST API canonical and/or collection links for this Singular Resource -
name(required): string
Title:
Name
Minimum Length:1
Maximum Length:255
The localized name of the DataFormQuestion object -
recordId(required): string
Title:
Record Id
Read Only:true
The unique identifier of the DataFormQuestion object -
referenceKey: string
Title:
Reference Key
Maximum Length:255
The reference key for the DataFormQuestion object -
required: boolean
Title:
Required
The flag that indicates whether or not this question is required -
sortOrder: integer
(int32)
Title:
Sort Order
The sort order of this question -
specialTypeIndicator: integer
(int32)
Title:
Special Type Indicator
The specialTypeIndicator field of the DataFormQuestion object
array
Answers
-
Array of:
object DataFormAnswerBO
Documentation for BO mode: AnswerBO
-
object
DataFormKeyBO
Documentation for BO mode: DataFormKeyBO
-
Title:
Data Form
Relationship to Rating
array
Links
object
-
dataFormQuestion:
dataFormQuestion
-
dateAdded(required): string
(date)
Title:
Date Added
Read Only:true
The date and time when this DataFormAnswer object was created. -
dateModified(required): string
(date)
Title:
Date Modified
Read Only:true
The date and time when this DataFormAnswer object was last modified. -
defaultAnswer: boolean
Title:
Default Answer
The flag that indicates whether or not this answer is the default answer -
links: array
Links
Title:
Links
REST API canonical and/or collection links for this Singular Resource -
name(required): string
Title:
Name
Minimum Length:1
Maximum Length:255
The localized name of the DataFormAnswer object -
numberValue: integer
(int32)
Title:
Number Value
The numeric value of the answer -
recordId(required): string
Title:
Record Id
Read Only:true
The unique identifier of the DataFormAnswer object -
referenceKey: string
Title:
Reference Key
Maximum Length:255
The reference key for the DataFormAnswer object -
sortOrder: integer
(int32)
Title:
Sort Order
The sort order of the answer
-
object
DataFormQuestionKeyBO
Documentation for BO mode: QuestionKeyBO
-
Title:
Data Form Question
Relationship to Question
array
Links
object
-
links: array
Links
Title:
Links
REST API canonical and/or collection links for this Singular Resource -
recordId(required): string
Title:
Record Id
Read Only:true
The unique identifier of the DataFormQuestion object -
referenceKey: string
Title:
Reference Key
Maximum Length:255
The reference key for the DataFormQuestion object
array
Links
object
-
links: array
Links
Title:
Links
REST API canonical and/or collection links for this Singular Resource -
recordId(required): string
Title:
Record Id
Read Only:true
The unique identifier of the DataForm object -
referenceKey(required): string
Title:
Reference Key
Minimum Length:1
Maximum Length:255
The reference key for the DataForm object
array
Links
object
-
canAssignTask: boolean
Title:
Can Assign tasks
Returns whether this user can assign tasks to other users. -
contentTypePrivileges: array
Content Type Privileges
Title:
Content Type Privileges
This field will return list of all contenttype privileges user have -
email: string
Title:
Email
Maximum Length:100
The user's e-mail address -
externalId: integer
(int64)
Title:
External Id
Read Only:true
The 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 user
Additional Properties Allowed: additionalPropertiesThis field will return list of all fucntional privileges user have -
links: array
Links
Title:
Links
Read Only:true
REST API canonical and/or collection links for this Singular Resource -
login: string
Title:
Login
Maximum Length:100
The user's login -
name: string
Title:
Name
Read Only:true
Maximum Length:100
User's full name -
recordId(required): integer
(int64)
Title:
Record Id
Read Only:true
The unique identifier of the user
array
Content Type Privileges
-
Array of:
object CompositeContentTypeBO
Composite of ContentTypeBO and its flattened relation. Keep in mind we can add more stuff down the line
object
Functional Privileges of user
array
Links
true
object
-
compositeWorkflowSteps(required): array
WorkflowSteps Composite BO
Title:
WorkflowSteps Composite BO
WorkflowSteps mapped to this content type and user privileges on that -
contentTypeKeyBO(required):
contentTypeKeyBO
-
hasContentTypeAccess: boolean
Title:
Has Content Type Access
Verifies if ContentTypeBO privileges are valid for user -
listOfPrivilege(required): array
List Of Privilege
Title:
List Of Privilege
List of Privileges for the ContentType
array
WorkflowSteps 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 BO
ContentBO object being created or updated
array
List Of Privilege
object
-
listOfPrivilege(required): array
List Of Privilege
Title:
List Of Privilege
List of Privileges for the WorkflowStep -
WorkflowStepKeyBO(required):
WorkflowStepKeyBO
array
List Of Privilege
-
object
WorkflowStepKeyBO
Documentation for BO mode: WorkflowStepKeyBO
-
Title:
WorkflowStep Key BO
WorkflowStep object being fetched
object
-
links: array
Links
Title:
Links
REST API canonical and/or collection links for this Singular Resource -
name: string
Title:
Name
Maximum Length:255
Localized name of the workflow step -
recordId(required): string
Title:
Record Id
Read Only:true
GUID from the WORKFLOWSTEP table -
referenceKey(required): string
Title:
Reference Key
Minimum Length:1
Maximum Length:100
Non localized name of the workflow step -
workflowId(required): string
Title:
WorkflowRecord Id
Read Only:true
GUID from the WORKFLOW table
array
Links
object
-
description: string
Title:
Description
Maximum Length:255
The 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:
Links
Read Only:true
REST API canonical and/or collection links for this Singular Resource -
name(required): string
Title:
Name
Minimum Length:1
Maximum Length:255
The 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 Id
Read Only:true
The unique identifier of the ContentType object. -
referenceKey(required): string
Title:
Reference Key
Minimum Length:1
Maximum Length:255
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. -
stripeCd(required): string
Title:
Stripe Cd
Maximum Length:30
Lookup code that indicates the stripe code. -
usageCode: string
Title:
Usage Code
Read Only:true
Maximum Length:30
Lookup code that indicates the product usage code. -
workflow:
workflow
array
Links
true
-
object
WorkflowKeyBO
-
Title:
Workflow
The 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:
0
Maximum Length:100
-
workflowVersion: integer
(int32)
object
-
links: array
Links
Title:
Links
Read Only:true
REST API canonical and/or collection links for this Singular Resource -
name: string
Title:
Name
Maximum Length:255
Localized name of the view -
recordId(required): string
Title:
Record Id
Read Only:true
GUID of the SITE table containing the view definition -
referenceKey(required): string
Title:
Reference Key
Minimum Length:1
Maximum Length:255
Non localized reference key for the view -
stripeCd: string
Title:
Stripe CD
Maximum Length:30
Stripe of a view
array
Links
true
object
-
links: array
Links
Title:
Links
REST API canonical and/or collection links for this Singular Resource -
questions: array
Questions
Title:
Questions
To Many Relationship to AggregateQuestionResult -
recordId(required): string
Title:
Record Id
Read Only:true
The unique record ID of the AggregateFormResults object. -
referenceKey: string
Title:
Reference Key
Maximum Length:255
The 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 Responses
TotalResponses of the AggregateFormResults object
array
Links
array
Questions
-
Array of:
object AggregateQuestionResultBO
Documentation for BO mode: AggregateQuestionResultBO
object
-
answers: array
Answers
Title:
Answers
To Many Relationship to AggregateAnswerResult -
averageResponse: number
(double)
Title:
Average Response
AverageResponse of the AggregateQuestionResult object -
name(required): string
Title:
Name
Minimum Length:1
Maximum Length:255
Localized display name for the Question -
recordId(required): string
Title:
Record Id
Read Only:true
The unique record ID of the AggregateQuestionResult object. -
referenceKey(required): string
Title:
Reference Key
Minimum Length:1
Maximum Length:255
The 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 Responses
TotalResponses of the AggregateQuestionResult object
array
Answers
-
Array of:
object AggregateAnswerResultBO
Documentation for BO mode: AggregateAnswerResultBO
object
-
name(required): string
Title:
Name
Minimum Length:1
Maximum Length:255
Localized display name for the Answer -
recordId(required): string
Title:
Record Id
Read Only:true
The unique record ID of the AggregateAnswerResult object. -
referenceKey: string
Title:
Reference Key
Maximum Length:255
The 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 Responses
TotalResponses of the AggregateAnswerResult object
object
-
lastUpdateDate: string
(date)
Title:
Last Update Date
Read Only:true
The date when the document was marked reviewed. -
lastUpdatedBy:
lastUpdatedBy
-
state:
state
-
string
Allowed Values:
[ "REVIEWED" ]
-
Title:
State
Read Only:true
review state for document.
object
-
allowMultipleNodes: boolean
Title:
Allow Multiple Nodes
Flag indicating if multiple nodes are allowed of this type@since 8.3 -
allowPreselectedUserGroupChange: boolean
Title:
Allow Preselected User Group Change
Enable editors to modify preselected user group restrictions@since 8.3 -
children: array
Children
Title:
Children
List of child nodes of the current element -
counter: integer
(int32)
Title:
Counter
This 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 Prefix
Maximum Length:50
This attribute contains the prefix that is appended to the front of the DOC ID counter -
dateAdded: string
(date)
Title:
Date Added
Read Only:true
The date and time when this SchemaAttribute definition was first created -
dateModified: string
(date)
Title:
Date Modified
Read Only:true
The date and time when this SchemaAttribute definition was last modified -
description: string
Title:
Description
Maximum Length:1000
Localized help text for the attribute. This text is displayed in the authoring view -
enableAttributeLevelSearch: boolean
Title:
Enable Attribute Level Search
Flag 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 Search
Flag 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 Identifier
Flag indicating whether this field should be appended to the master identifier of the document -
isNode: boolean
Title:
Is Node
Flag indicating if this element is a node@since 8.3 -
isRequired: boolean
Title:
Is Required
Make attribute a required field@since 8.3 -
links: array
Links
Title:
Links
REST API canonical and/or collection links for this Singular Resource -
localizedAttributes: array
Localized Attributes
Title:
Localized Attributes
List of LocalizedAttributes of this SchemaAttribute name and description in various Locales -
name(required): string
Title:
Name
Minimum Length:1
Maximum Length:255
Localized name of the attribute. This need NOT be unique within the Schema. -
readOnly: boolean
Title:
Read Only
Flag indicating whether this field is editable -
recordId: string
Title:
Record Id
Read Only:true
Unique identifier for the SchemaAttribute object -
referenceKey(required): string
Title:
Reference Key
Minimum Length:1
Maximum Length:100
Non 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 Approval
Attribute requires workflow approval if workflow is enabled -
schemaAttributeUserGroupList: array
Schema Attribute User Group List
Title:
Schema Attribute User Group List
List 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 Resource
Flag 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 Groups
Restrict attribute to selected user groups -
securityRegex: string
Title:
Security Regex
Maximum Length:100
The regular expression used to validate the field against security attacks. -
sortOrder: integer
(int32)
Title:
Sort Order
Display order of the schema attributes within the edit form -
textHeight: string
Title:
Text Height
Maximum Length:10
Specifies the text height for text areas and rich text fields -
textWidth: string
Title:
Text Width
Maximum Length:10
Specifies the max length for text fields -
userGroupSelectionRequired: boolean
Title:
User Group Selection Required
User groups are required for attribute -
wysiwygType:
wysiwygType
-
xpath: string
Title:
Xpath
Maximum Length:2000
The XPATH of this attribute within the schema. This is unique within the Schema.
array
Children
-
Array of:
object SchemaAttributeBO
Documentation for BO mode: SchemaAttributeBO
array
Links
array
Localized Attributes
array
Schema 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 Type
Enumerated type representing the type of attribute - i.e. text field, rich text area
-
string
Allowed Values:
[ "BASIC", "FULL", "MEDIUM" ]
-
Title:
Wysiwyg Type
Type of WYSIWYG rich text field - i.e. FULL, BASIC, MEDIUM@since 8.3
object
-
description: string
Title:
Description
Maximum Length:1000
Localized description in the above Locale -
localeId(required): string
Title:
Locale Id
Read Only:true
RecordId of the Locale - generally this is the localeCode (like en_US) and NOT a real GUID. -
name(required): string
Title:
Name
Minimum Length:1
Maximum Length:255
Localized Name in the above Locale
object
-
defaultValue: boolean
-
recordId: string
-
userGroup: object
UserGroupKeyBO
Documentation for BO mode: UserGroupKeyBO
object
-
links: array
Links
Title:
Links
Read Only:true
The collection links related to this resource -
name: string
Title:
Name
Read Only:true
Maximum Length:255
The localized name of the user group. The name field can only be used for sorting. -
recordId: string
Title:
Record Id
The unique identifier from the TAG table that represent a userGroups resource -
referenceKey: string
Title:
Reference Key
Maximum Length:255
The non localized name of the user group -
stripeCd: string
Title:
Stripe CD
Read Only:true
Maximum Length:30
Stripe for UserGroup
array
Links
true
object
-
allowDocumentEditing: boolean
Title:
Allow Document Editing
Flag indicating whether this step allows document editing -
dateAdded(required): string
(date)
Title:
Date Added
Read Only:true
The date and time when this work flow step was added. -
dateModified(required): string
(date)
Title:
Date Modified
Read Only:true
The date and time when this work flow step was last modified. -
defaultStepDurationInMinutes: integer
(int32)
Title:
Default Workflow Step Due date in minutes
Time in minutes that the workflow step task will stay in queue before being consdiered overdue -
links: array
Links
Title:
Links
REST API canonical and/or collection links for this Singular Resource -
name: string
Title:
Name
Maximum Length:255
Localized name of the workflow step -
onlyAssigneeCanAppove: boolean
Title:
Can only assignee approve step
Flag indicating whether this step can only be approved by workflow step task assignee -
recordId(required): string
Title:
Record Id
Read Only:true
GUID from the WORKFLOWSTEP table -
referenceKey(required): string
Title:
Reference Key
Minimum Length:1
Maximum Length:100
Non localized name of the workflow step -
sortOrder: integer
(int32)
Title:
Sort Order
The order of the workflow steps within the workflow -
workflowId(required): string
Title:
WorkflowRecord Id
Read Only:true
GUID from the WORKFLOW table
array
Links