Update content
/km/api/v1/content/{id}
Supported Media Types: 'application/json', 'application/xml'
This method updates content in the master locale or any other locale (to which content is already translated). The method creates a translation in a new locale other than the master locale.
When updating a content record, the service validates the conditional content including the nested conditional content for the user-interface fields within the XML input.
When updating a content record, the user may add ReasonForEdit to the payload as plain text only (Does not accept HTML or JavaScript)
Note : This field is not displayed using Get/Content. It is available as a comment when Content History is retrieved.
Content Security
The service uses the security role permissions of the logged-in user to determine whether the user has the modify privilege in the content type. The content is created only if the user has the modify privileges. A locale must be specified as user's default locale, otherwise service returns an error.
Update content with file attachments
Supported Media Types: 'multipart/form-data'
You can update a content record having a file attachment. You do not need to pass in the file of an existing attachment when updating a content record. You need to just pass in the updated Business Object in the HTTP request, and the service updates the content record and associates the previous file attachment with the latest version of the content record. If you are attaching a new file that is not already associated with the latest content record, the service will copy the file attachments that are already associated with the content record and also associates the new file attachment with the latest content record.
To update a content record with new attachment, you have to specify a file node of the attached file in the content XML payload and pass the file in FILEPART of the request.
If there are more than one file attachment in content then file node needs to be repeated for each file.
If any file attachment from previous version needs to be removed then file node of that file attachment can be removed from the content xml.
If any file attachment needs to be same from previous version then file node for those attachments should be kept as is in content xml with their ID node. Also, since there no changes file should not be passed in FILEPART.
Below are the details of the file node:
Node | Required | Description |
---|---|---|
KM_ATTACHMENTS_ATTR | YES | Root node in for each file attachment. |
FILE | YES | Parent node for file details of attachment. |
ID | NO | This is a unique identifier for the file. After content is created this field will be populated with file reference for new uploaded file.
|
FILENAME | YES | Name of the attachment file. This name must match with the name of the file uploaded in FILEPART. |
TITLE | NO | Title for the attachment file, if not passed it will be defaulted to file name. |
DESCRIPTION | YES | Description of file attachment. |
Below are minimal payload examples(using one file attachment).
XML Examples:
<Content>
<recordId>CONTENT_RECORD_ID</recordId>
<versionId>CONTENT_VERSION_ID</versionId>
<documentId>CONTENT_DOCUMENT_ID</documentId>
<version>CONTENT_VERSION</version>
<answerId>CONTENT_ANSWER_ID</answerId>
<locale>
<recordId>LOCALE_CODE</recordId>
</locale>
<dateModified>2018-05-30T07:52:23-0700</dateModified>
<contentType>
<recordId>CONTENT_TYPE_RECORD_ID</recordId>
<referenceKey>CONTENT_TYPE_REF_KEY</referenceKey>
<name>CONTENT_TYPE_NAME</name>
</contentType>
<createDate>2018-05-30T07:52:23-0700</createDate>
<lastModifiedDate>2018-05-30T07:52:23-0700</lastModifiedDate>
<dateAdded>2018-05-30T07:52:23-0700</dateAdded>
<displayStartDate>1900-01-01T03:00:00-0500</displayStartDate>
<displayEndDate>9999-12-31T03:00:00-0500</displayEndDate>
<owner>
<recordId>OWNER_RECORD_ID</recordId>
<name>OWNER_NAME</name>
<email>OWNER_EMAIL</email>
<externalType>ACCOUNT</externalType>
</owner>
<published>false</published>
<pending>false</pending>
<checkedOut>false</checkedOut>
<xml>
<CONTENT_TYPE_REF_KEY>
<KM_ATTACHMENTS_ATTR>
<FILE>
<ID>
<![CDATA[DOCUMENT_ID]]>
</ID>
<FILENAME>
<![CDATA[FILE_NAME]]>
</FILENAME>
<TITLE>
<![CDATA[OPTIONAL_FILE_TITLE]]>
</TITLE>
<DESCRIPTION>
<![CDATA[FILE_DESCRIPTION]]>
</DESCRIPTION>
</FILE>
</KM_ATTACHMENTS_ATTR>
</CONTENT_TYPE_REF_KEY>
</xml>
<isForEdit>true</isForEdit>
<categories/>
<userGroups/>
<views>
<ViewKey>
<recordId>VIEW_RECORD_ID</recordId>
<referenceKey>VIEW_REF_KEY</referenceKey>
<name>VIEW_NAME</name>
</ViewKey>
</views>
</Content>
JSON Example:
{
'recordId': 'CONTENT_RECORD_ID',
'versionId': 'CONTENT_VERSION_ID',
'documentId': 'CONTENT_DOCUMENT_ID',
'version': 'CONTENT_VERSION',
'answerId': 'CONTENT_ANSWER_ID',
'locale': {
'recordId': 'LOCALE_CODE'
},
'dateModified': '2018-05-30T07:52:23-0700',
'contentType': {
'recordId': 'CONTENT_TYPE_RECORD_ID',
'referenceKey': 'CONTENT_TYPE_REF_KEY',
'name': 'CONTENT_TYPE_NAME'
},
'createDate': '2018-05-30T07:52:23-0700',
'lastModifiedDate': '2018-05-30T07:52:23-0700',
'dateAdded': '2018-05-30T07:52:23-0700',
'displayStartDate': '1900-01-01T03:00:00-0500',
'displayEndDate': '9999-12-31T03:00:00-0500',
'owner': {
'recordId': 'OWNER_RECORD_ID',
'name': 'OWNER_NAME',
'email': 'OWNER_EMAIL',
'externalType': 'ACCOUNT'
},
'published': 'false',
'pending': 'false',
'checkedOut': 'false',
'xml': '<CONTENT_TYPE_REF_KEY><KM_ATTACHMENTS_ATTR><FILE><ID><![CDATA[DOCUMENT_ID]]></ID><FILENAME>
<![CDATA[FILE_NAME]]></FILENAME><TITLE><![CDATA[OPTIONAL_FILE_TITLE]]></TITLE><DESCRIPTION><![CDATA[FILE_DESCRIPTION]]>
</DESCRIPTION></FILE></KM_ATTACHMENTS_ATTR></CONTENT_TYPE_REF_KEY>',
'isForEdit': 'true',
'views': [{
'recordId': 'VIEW_RECORD_ID',
'referenceKey': 'VIEW_REF_KEY',
'name': 'VIEW_NAME'
}]
}
The XML file must contain the following information:
- The new attachment's file name.
- The existing attachment's file name that you want the service to copy to the latest version of the content record.
Response Errors
Following are the possible error responses for this method:
- OKDOM-CONT0110
The error occurs when you specify an invalid UserGroup object in the conditional section. You can access the content only if the UserGroup object of the conditional section is mapped to you.
- OK-FMS0005
The error occurs when the file nodes specified in the XML file do not match the uploaded files.
- OKDOM-FMS0001
The error occurs if you do not specifiy the name of the new attachment and the names of the exiting file attachments with the request.
- OKDOM-CONT0202
The error occurs when file description specified in the XML exceeds its max size
- OKDOM-SCHEMA0018
The error occurs when file description is not specified in the XML
- OKDOM-CONT0203
The error occurs when duplicate files attached
- $ERROR.Content.INACTIVE_ARTICLE_STATUS_ASSIGNED$
The error occurs when the ContentUpdateBO.articleStatus specified with the request is inactive.
- $ERROR.Content.ARTICLE_STATUS_FEATURE_NOT_AVAILABLE$
The error occurs when a ContentUpdateBO.articleStatus is specified with the request and the article status feature is not available.
Request
- application/xml
- multipart/form-data
- application/json
-
id: string
The unique identifier of the object to be updated.
object
Content
-
allTranslations(optional):
array allTranslations
This field will return list of all translated content that the user can view
This field will only be populated if allTranslations query parameter is passed in with value true.
-
answerId(optional):
integer
The unique identifier that enables mapping between an answer and the content.
-
articleStatus(optional):
object ArticleStatusKey
Title:
ArticleStatusKey
-
basedLocale(optional):
object LocaleKey
Title:
LocaleKey
-
basedOnVersion(optional):
string
Version of the Content object
-
categories(optional):
array categories
The Category object or list of Category objects assigned to the Content.
For example. If world is a category at level one, we may have Africa, Uk, America etc. at level two. You can specify requests for objects in a category hierarchically or non- hierarchically. If a content that is assigned Florida is requested using hierarchical request world, you get the result. Whereas, the same request done non- hierarchically gives no result.
The category parameter lets you filter the result by first level category as well as hierarchical category in both single and multiple configurations.
- Match Any
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey eq 'WORLD'&mode=KEY
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey in ('WORLD')&mode=KEY
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey withNoChildren 'WORLD'&mode=KEY
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey inWithNoChildren ('WORLD')&mode=KEY
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey in ('AGILE_CHANNEL', 'NEWS_CHANNEL') and categories.refKey inWithNoChildren ('USA', 'EUROPE')&mode=KEY&orderBy=mostPopular
The following example URIs returns Content objects that match the multiple criterion specified in the request
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey in ('AGILE_CHANNEL', 'NEWS_CHANNEL') and categories.refKey inWithNoChildren ('USA', 'EUROPE') and filterMode.contentState eq 'PUBLISHED'&mode=KEY&orderBy=mostRecent
The objects in the returned list are sorted by the published Date.
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey in ('AGILE_CHANNEL', 'NEWS_CHANNEL') and categories.refKey inWithNoChildren ('USA', 'EUROPE') and filterMode.contentState eq 'LATESTVALID'&mode=KEY&orderBy=mostRecent
The objects in the returned list are sorted by the dateModified.
The service matches any of the category specified in the request if you pass the
contentType.refKey eq
parameter orcontentType.refKey in
parameter with the request.Example URIs for the category parameter are as follows:
OR
The following example URIs returns Content objects which exist at the level of the specified category. This does not return the child Content objects.
OR
The following example URIs returns Content objects that match the multiple criterion specified in the request.
- Match ALL
http://<IM_REST_API_HOST>/km/api/content?q=contentState eq 'LATEST' and contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey matchAll ('WORLD', 'MOVIES')&mode=KEY
The request returns all Content objects in the world and movies category. The service returns a Content object in the category Africa because Africa is a child category for the category world.
http://<IM_REST_API_HOST>/km/api/content?q=contentState eq 'LATEST' and contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey matchAll ('WORLD', 'MOVIES')&mode=KEY&orderBy=mostPopular
The objects in the returned list are sorted by the view in descending order.
http://<IM_REST_API_HOST>/km/api/content?q=contentState eq 'PUBLISHED' and contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey matchAll ('WORLD', 'MOVIES')&mode=KEY&orderBy=mostRecent
The objects in the returned list are sorted by the published date descending order.
The service matches all the categories specified in the request if you pass the
andcategories.refKey matchAll
parameter with the request. -
checkedOut(optional):
boolean
The date when an author has checked out or locked the document for editing.
-
checkedOutBy(optional):
object UserKey
Title:
UserKey
-
contentType(optional):
object ContentTypeKey
Title:
ContentTypeKey
-
createDate(optional):
string(date-time)
The date when the content was created. For legacy systems, the create date is the date when the document was created in those systems.
-
creator(optional):
object UserKey
Title:
UserKey
-
dateAdded(optional):
string(date-time)
The date when the content was added to the content type. For legacy systems, the create date is the date when the document was migrated from the legacy system to the Oracle Knowledge Repository.
-
dateModified(optional):
string(date-time)
The date when the content was last modified in the Oracle Knowledge Repository.
-
displayEndDate(optional):
string(date-time)
The date when the service stops the display of the document to the end users.
-
displayPosition(optional):
Allowed Values:
[ "FIXED_AT_TOP", "PLACE_AT_TOP", "HISTORICAL_USEFULNESS" ]
LookUp code that can be Fixed@Top, Place@Top , Historical Usefulness -
displayReviewDate(optional):
string(date-time)
The date when the document requires a review by an author capable of performing the review.
-
displayStartDate(optional):
string(date-time)
The date when the document will be available to display to end-users.
-
documentId(optional):
string
The unique identifier of a document that indicates the content type in which the content is saved.
-
eventEndDate(optional):
string(date-time)
The date when the document's event ends.
-
eventStartDate(optional):
string(date-time)
The date when the document's event begins.
-
isForEdit(optional):
boolean
The parameter to request editable content.
-
lastModifiedDate(optional):
string(date-time)
The date when the content was last modified. For legacy systems, the lastModifiedDate date is the date when the document was last modified in those systems.
-
lastModifier(optional):
object UserKey
Title:
UserKey
-
latestContent(optional):
object ContentKey
Title:
ContentKey
-
links(optional):
array links
-
locale(optional):
object LocaleKey
Title:
LocaleKey
-
metaDataResourcePath(optional):
string
MetaDataResourcePath of the Content object
-
metaDataXml(optional):
string
MetaDataXml of the Content object
-
owner(optional):
object UserKey
Title:
UserKey
-
pending(optional):
boolean
The flag that indicates whether the document is pending for publication.
-
priority(optional):
Allowed Values:
[ "PRIORITY_0", "PRIORITY_1", "PRIORITY_2", "PRIORITY_3", "PRIORITY_4", "PRIORITY_5", "PRIORITY_6", "PRIORITY_7", "PRIORITY_8", "PRIORITY_9", "PRIORITY_10", "PRIORITY_11", "PRIORITY_12", "PRIORITY_13", "PRIORITY_14", "PRIORITY_15", "PRIORITY_16", "PRIORITY_17", "PRIORITY_18", "PRIORITY_19", "PRIORITY_20" ]
The priority assigned to the content.
The valid values are: PRIORITY_0 to PRIORITY_20. For example, PRIORITY_1 or PRIORITY_18 are valid values, but PRIORITY_21 is not.
-
publishDate(optional):
string(date-time)
The date when the document was first displayed to end users.
-
published(optional):
boolean
The flag that indicates whether the document is published.
-
publishedContent(optional):
object ContentKey
Title:
ContentKey
-
publishedVersion(optional):
string
Version of the Content object
-
rating(optional):
object DataForm
Title:
DataForm
-
ratingsAggregate(optional):
object AggregateFormResults
Title:
AggregateFormResults
-
reasonForEdit(optional):
string
Reasons for editing or creating a content. This will only be used when creating or updating the document.
-
recordId(optional):
string
The unique identifier of the document. This ID is same in all versions in all locales of the document.
-
replacementTokens(optional):
array replacementTokens
The object to create short, manageable terms (the tokenName). These tokens represent standardized, translatable, and sometimes complex content, such as integrated text, images, lists, and tables.
-
resourcePath(optional):
string
EXAMPLE URL : http://<IM_REST_API_HOST>/okcs/resources/{TENANTID}/content/draft/{CONTENTID}/{CONTENTTEXTID}/{FILENAME_WITH_EXTENSION}?login={USER_NAME}. If the user name is not passed then it will be defaulted to 'guest' user.
-
schemaAttributes(optional):
array schemaAttributes
This field will return list of schema attributes associated with the content type of this content.
This field will only be populated if additionalFields query parameter is passed in with value schemaAttributes.
-
title(optional):
string
The tittle of the document.
-
userGroups(optional):
array userGroups
The 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(optional):
string
Version of the Content object
-
versionId(optional):
string
The unique identifier of the specific version of a document in a specific locale. You cannot use this field in queries made using q query parameter.
-
views(optional):
array views
The 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.
-
wfStepNotificationOverride(optional):
string(date-time)
The date when the service sends notification to the author involved in the review. Once the workflow notification is given, the service updates the next review date.
-
workflowStep(optional):
object WorkflowStepKey
Title:
WorkflowStepKey
-
xml(optional):
string
Xml of the Content object
array
This field will return list of all translated content that the user can view
This field will only be populated if allTranslations query parameter is passed in with value true.
-
Array of:
object ContentKey
Title:
ContentKey
object
ArticleStatusKey
-
links(optional):
array links
-
name(optional):
string
The localized name of the ArticleStatus object. The name field can only be used for sorting.
-
recordId(optional):
string
The unique identifier of the ArticleStatus object.
-
referenceKey(optional):
string
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.
object
LocaleKey
-
links(optional):
array links
-
recordId(optional):
string
The unique identifier of the Locale object.
array
The Category object or list of Category objects assigned to the Content.
For example. If world is a category at level one, we may have Africa, Uk, America etc. at level two. You can specify requests for objects in a category hierarchically or non- hierarchically. If a content that is assigned Florida is requested using hierarchical request world, you get the result. Whereas, the same request done non- hierarchically gives no result.
The category parameter lets you filter the result by first level category as well as hierarchical category in both single and multiple configurations.
- Match Any
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey eq 'WORLD'&mode=KEY
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey in ('WORLD')&mode=KEY
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey withNoChildren 'WORLD'&mode=KEY
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey inWithNoChildren ('WORLD')&mode=KEY
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey in ('AGILE_CHANNEL', 'NEWS_CHANNEL') and categories.refKey inWithNoChildren ('USA', 'EUROPE')&mode=KEY&orderBy=mostPopular
The following example URIs returns Content objects that match the multiple criterion specified in the request
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey in ('AGILE_CHANNEL', 'NEWS_CHANNEL') and categories.refKey inWithNoChildren ('USA', 'EUROPE') and filterMode.contentState eq 'PUBLISHED'&mode=KEY&orderBy=mostRecent
The objects in the returned list are sorted by the published Date.
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey in ('AGILE_CHANNEL', 'NEWS_CHANNEL') and categories.refKey inWithNoChildren ('USA', 'EUROPE') and filterMode.contentState eq 'LATESTVALID'&mode=KEY&orderBy=mostRecent
The objects in the returned list are sorted by the dateModified.
The service matches any of the category specified in the request if you pass the contentType.refKey eq
parameter or contentType.refKey in
parameter with the request.
Example URIs for the category parameter are as follows:
OR
The following example URIs returns Content objects which exist at the level of the specified category. This does not return the child Content objects.
OR
The following example URIs returns Content objects that match the multiple criterion specified in the request.
- Match ALL
http://<IM_REST_API_HOST>/km/api/content?q=contentState eq 'LATEST' and contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey matchAll ('WORLD', 'MOVIES')&mode=KEY
The request returns all Content objects in the world and movies category. The service returns a Content object in the category Africa because Africa is a child category for the category world.
http://<IM_REST_API_HOST>/km/api/content?q=contentState eq 'LATEST' and contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey matchAll ('WORLD', 'MOVIES')&mode=KEY&orderBy=mostPopular
The objects in the returned list are sorted by the view in descending order.
http://<IM_REST_API_HOST>/km/api/content?q=contentState eq 'PUBLISHED' and contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey matchAll ('WORLD', 'MOVIES')&mode=KEY&orderBy=mostRecent
The objects in the returned list are sorted by the published date descending order.
The service matches all the categories specified in the request if you pass the andcategories.refKey matchAll
parameter with the request.
-
Array of:
object CategoryKey
Title:
CategoryKey
object
UserKey
-
email(optional):
string
Email of the User object
-
externalId(optional):
integer
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.
-
externalType(optional):
string
The ExternalType is the type of the corresponding User from an external system. It, along with ExternalId, can be used to bridge the gap between a User from this system and a User from an external system.
-
links(optional):
array links
-
name(optional):
string
User's full name
-
recordId(optional):
string
The unique record ID of the User object.
object
ContentTypeKey
-
description(optional):
string
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(optional):
array links
-
name(optional):
string
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(optional):
string
The unique identifier of the ContentType object.
-
referenceKey(optional):
string
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(optional):
string
Lookup code that indicates the stripe code.
object
ContentKey
-
allTranslations(optional):
array allTranslations
This field will return list of all translated content that the user can view
This field will only be populated if allTranslations query parameter is passed in with value true.
-
answerId(optional):
integer
The unique identifier that enables mapping between an answer and the content.
-
articleStatus(optional):
object ArticleStatusKey
Title:
ArticleStatusKey
-
dateModified(optional):
string(date-time)
The date when the content was last modified in the Oracle Knowledge Repository.
-
displayEndDate(optional):
string(date-time)
The date when the service stops the display of the document to the end users.
-
displayReviewDate(optional):
string(date-time)
The date when the document requires a review by an author capable of performing the review.
-
displayStartDate(optional):
string(date-time)
The date when the document will be available to display to end-users.
-
documentId(optional):
string
The unique identifier of a document that indicates the content type in which the content is saved.
-
latestContent(optional):
object ContentKey
Title:
ContentKey
-
links(optional):
array links
-
locale(optional):
object LocaleKey
Title:
LocaleKey
-
publishedContent(optional):
object ContentKey
Title:
ContentKey
-
rating(optional):
object DataForm
Title:
DataForm
-
ratingsAggregate(optional):
object AggregateFormResults
Title:
AggregateFormResults
-
recordId(optional):
string
The unique identifier of the document. This ID is same in all versions in all locales of the document.
-
schemaAttributes(optional):
array schemaAttributes
This field will return list of schema attributes associated with the content type of this content.
This field will only be populated if additionalFields query parameter is passed in with value schemaAttributes.
-
title(optional):
string
The tittle of the document.
-
version(optional):
string
Version of the Content object
-
versionId(optional):
string
The unique identifier of the specific version of a document in a specific locale. You cannot use this field in queries made using q query parameter.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
object
DataForm
-
dateAdded(optional):
string(date-time)
The date when the DataForm object was created or added
-
dateModified(optional):
string(date-time)
The date when the DataForm object was last modified.
-
displayEndDate(optional):
string(date-time)
DisplayEndDate of the DataForm object
-
displayStartDate(optional):
string(date-time)
DisplayStartDate of the DataForm object
-
emailContent(optional):
boolean
EmailContent of the DataForm object
-
links(optional):
array links
-
name(optional):
string
The name of the data form. The name field can only be used for sorting.
-
questions(optional):
array questions
To Many Relationship to Question
-
ratingType(optional):
integer
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(optional):
string
The unique record ID of the DataForm object.
-
referenceKey(optional):
string
The reference key for the DataForm object. DataForm objects support multiple languages. This field can be used to identify the associated objects for all languages.
-
user(optional):
object UserKey
Title:
UserKey
-
views(optional):
array views
To Many Relationship to View
object
AggregateFormResults
-
links(optional):
array links
-
questions(optional):
array questions
To Many Relationship to AggregateQuestionResult
-
recordId(optional):
string
The unique record ID of the AggregateFormResults object.
-
referenceKey(optional):
string
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(optional):
integer
TotalResponses of the AggregateFormResults object
array
The object to create short, manageable terms (the tokenName). These tokens represent standardized, translatable, and sometimes complex content, such as integrated text, images, lists, and tables.
-
Array of:
object ReplacementToken
Title:
ReplacementToken
array
This field will return list of schema attributes associated with the content type of this content.
This field will only be populated if additionalFields query parameter is passed in with value schemaAttributes.
-
Array of:
object SchemaAttribute
Title:
SchemaAttribute
array
The user groups assigned to the content. Only the members of the assigned user group will have access to the content. Default value is Everyone.
-
Array of:
object UserGroupKey
Title:
UserGroupKey
array
The 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.
-
Array of:
object ViewKey
Title:
ViewKey
object
WorkflowStepKey
-
links(optional):
array links
-
name(optional):
string
Localized name of the workflow step
-
recordId(optional):
string
GUID from the WORKFLOWSTEP table
-
referenceKey(optional):
string
Non localized name of the workflow step
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
object
-
href:
string
URI [RFC3986] or URI Template [RFC6570]. If the value is set to URI Template, then the "templated" property must be set to true.
-
mediaType(optional):
string
Media type, as defined by RFC 2046, describing the link target.
-
method(optional):
string
HTTP method for requesting the target of the link.
-
profile(optional):
string
Link to the metadata of the resource, such as JSON-schema, that describes the resource expected when dereferencing the target resource..
-
rel:
string
Name of the link relation that, in addition to the type property, can be used to retrieve link details. For example, href or profile.
-
templated(optional):
boolean
Boolean flag that specifies that "href" property is a URI or URI Template. If the property is a URI template, set this value to true. By default, this value is false.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
object
CategoryKey
-
childrenCount(optional):
integer
This field will return number of immediate children a category has.
This field will only be populated if childrenCount query parameter is passed in with value true.
Example URIs for the this parameter are as follows:
- http://<IM_REST_API_HOST>/km/api/categories/{id}?childrenCount=true&mode=KEY
- http://<IM_REST_API_HOST>/km/api/categories?childrenCount=true&mode=KEY
- http://<IM_REST_API_HOST>/km/api/categories?q=contentTypeRefKey eq 'FAQ'&childrenCount=true&mode=KEY
-
description(optional):
string
Description of the Category object
-
externalId(optional):
integer
The unique identifier used while integrating the repository data with the external system.
-
externalType(optional):
string
The type of the category used while integrating the repository data with the external system. Valid options are PRODUCT and CATEGORY.
-
inventoryOrgId(optional):
integer
The inventory organization id of the specific product.
-
links(optional):
array links
-
name(optional):
string
The name of the category.
-
objectId(optional):
string
The hierarchichal position of the category
-
parents(optional):
array parents
This field will return all parents of category.
This field will only be populated if withParents query parameter is passed in with value true.
Example URIs for the this parameter are as follows:
- http://<IM_REST_API_HOST>/km/api/categories/{id}?withParents=true&mode=KEY
- http://<IM_REST_API_HOST>/km/api/categories?withParents=true&mode=KEY
- http://<IM_REST_API_HOST>/km/api/categories?q=contentTypeRefKey eq 'FAQ'&withParents=true&mode=KEY
- http://<IM_REST_API_HOST>/km/api/categories/{id}?childrenCount=true&withParents=true&mode=KEY
-
recordId(optional):
string
The unique record ID of the Category object.
-
referenceKey(optional):
string
The reference key for the Category object. Category objects support multiple languages. This field can be used to identify the associated objects for all languages.
-
responseLocale(optional):
string
This is a custom field that will get populated if a name is translated into the default locale when the translated name is not found.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
This field will return all parents of category.
This field will only be populated if withParents query parameter is passed in with value true.
Example URIs for the this parameter are as follows:
- http://<IM_REST_API_HOST>/km/api/categories/{id}?withParents=true&mode=KEY
- http://<IM_REST_API_HOST>/km/api/categories?withParents=true&mode=KEY
- http://<IM_REST_API_HOST>/km/api/categories?q=contentTypeRefKey eq 'FAQ'&withParents=true&mode=KEY
- http://<IM_REST_API_HOST>/km/api/categories/{id}?childrenCount=true&withParents=true&mode=KEY
-
Array of:
object CategoryKey
Title:
CategoryKey
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
This field will return list of all translated content that the user can view
This field will only be populated if allTranslations query parameter is passed in with value true.
-
Array of:
object ContentKey
Title:
ContentKey
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
This field will return list of schema attributes associated with the content type of this content.
This field will only be populated if additionalFields query parameter is passed in with value schemaAttributes.
-
Array of:
object SchemaAttribute
Title:
SchemaAttribute
object
SchemaAttribute
-
allowMultipleNodes(optional):
boolean
Flag indicating if multiple nodes are allowed of this type @since 8.3
-
allowPreselectedUserGroupChange(optional):
boolean
Enable editors to modify preselected user group restrictions @since 8.3
-
children(optional):
array children
List of child nodes of the current element
-
counter(optional):
integer
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(optional):
string
This attribute contains the prefix that is appended to the front of the DOC ID counter
-
dateAdded(optional):
string(date-time)
This attribute represents the timestamp when the SchemaAttribute definition was first created
-
dateModified(optional):
string(date-time)
This attribute represents the timestamp when the SchemaAttribute definition was last modified
-
description(optional):
string
Localized help text for the attribute. This text is displayed in the authoring view
-
enableAttributeLevelSearch(optional):
boolean
Flag indicating whether this field should be configured for attribute level searching - i.e. where TITLE='xyz'. This field was previously called searchable @since 8.3
-
enableFullTextSearch(optional):
boolean
Flag indicating whether this field should be included in the full text index. This field was previously called indexable @since 8.3
-
includeInMasterIdentifier(optional):
boolean
Flag indicating whether this field should be appended to the master identifier of the document
-
isNode(optional):
boolean
Flag indicating if this element is a node @since 8.3
-
isRequired(optional):
boolean
Make attribute a required field @since 8.3
-
links(optional):
array links
-
localizedAttributes(optional):
array localizedAttributes
List of LocalizedAttributes of this SchemaAttribute name and description in various Locales
-
name(optional):
string
Localized name of the attribute. This need NOT be unique within the Schema.
-
readOnly(optional):
boolean
Flag indicating whether this field is editable
-
recordId(optional):
string
Unique identifier for the SchemaAttribute object
-
referenceKey(optional):
string
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(optional):
boolean
Attribute requires workflow approval if workflow is enabled
-
schemaAttributeUserGroupList(optional):
array schemaAttributeUserGroupList
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(optional):
Allowed Values:
[ "TEXT_AREA", "WYSIWYG_EDIT", "TEXT_FIELD", "FILE", "BOOLEAN", "LIST", "COUNTER", "DATE", "DATETIME", "TIME", "INTEGER", "FLOAT" ]
Enumerated type representing the type of attribute - i.e. text field, rich text area -
securedFileResource(optional):
boolean
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(optional):
boolean
Restrict attribute to selected user groups
-
securityRegex(optional):
string
The regular expression used to validate the field against security attacks.
-
sortOrder(optional):
integer
Display order of the schema attributes within the edit form
-
textHeight(optional):
string
Specifies the text height for text areas and rich text fields
-
textWidth(optional):
string
Specifies the max length for text fields
-
userGroupSelectionRequired(optional):
boolean
User groups are required for attribute
-
wysiwygType(optional):
Allowed Values:
[ "BASIC", "MEDIUM", "FULL" ]
Type of WYSIWYG rich text field - i.e. FULL, BASIC, MEDIUM @since 8.3 -
xpath(optional):
string
The XPATH of this attribute within the schema. This is unique within the Schema.
array
-
Array of:
object SchemaAttribute
Title:
SchemaAttribute
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
-
Array of:
object LocalizedAttributes
Title:
LocalizedAttributes
array
-
Array of:
object SchemaAttributeUserGroup
Title:
SchemaAttributeUserGroup
object
LocalizedAttributes
-
description(optional):
string
Localized description in the above Locale
-
localeId(optional):
string
RecordId of the Locale - generally this is the localeCode (like en_US) and NOT a real GUID.
-
name(optional):
string
Localized Name in the above Locale
object
SchemaAttributeUserGroup
-
defaultValue(optional):
boolean
Flag indiacting whether the user group should be selected by default
-
recordId(optional):
string
GUID from the XMLSCHEMAATTRIBUTEUSERGROUP table
-
userGroup(optional):
object UserGroupKey
Title:
UserGroupKey
object
UserGroupKey
-
externalId(optional):
integer
The unique identifier of the corresponding userGroup from an external system. You can use the External ID with the ExternalType parameter to connect user groups in the internal and the the external systems.
-
externalType(optional):
string
The ExternalType is the type of the corresponding userGroup from an external system.
-
links(optional):
array links
-
name(optional):
string
The localized name of the user group. The name field can only be used for sorting.
-
recordId(optional):
string
The unique identifier from the TAG table that represent a userGroups resource
-
referenceKey(optional):
string
The non localized name of the user group
-
stripeCD(optional):
string
Stripe for UserGroup
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
-
Array of:
object DataFormQuestion
Title:
DataFormQuestion
array
-
Array of:
object ViewKey
Title:
ViewKey
object
DataFormQuestion
-
answers(optional):
array answers
To Many Relationship to Answer
-
dataForm(optional):
object DataFormKey
Title:
DataFormKey
-
dateAdded(optional):
string(date-time)
The date when the DataFormQuestion object was created or added
-
dateModified(optional):
string(date-time)
The date when the DataFormQuestion object was last modified.
-
isMasterIdentifier(optional):
boolean
IsMasterIdentifier of the DataFormQuestion object
-
links(optional):
array links
-
name(optional):
string
Name of the DataFormQuestion object
-
recordId(optional):
string
The unique record ID of the DataFormQuestion object.
-
referenceKey(optional):
string
The reference key for the DataFormQuestion object. DataFormQuestion objects support multiple languages. This field can be used to identify the associated objects for all languages.
-
required(optional):
boolean
Required of the DataFormQuestion object
-
sortOrder(optional):
integer
SortOrder of the DataFormQuestion object
-
specialTypeIndicator(optional):
integer
SpecialTypeIndicator of the DataFormQuestion object
array
-
Array of:
object DataFormAnswer
Title:
DataFormAnswer
object
DataFormKey
-
links(optional):
array links
-
recordId(optional):
string
The unique record ID of the DataForm object.
-
referenceKey(optional):
string
The reference key for the DataForm object. DataForm objects support multiple languages. This field can be used to identify the associated objects for all languages.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
object
DataFormAnswer
-
dataFormQuestion(optional):
object DataFormQuestionKey
Title:
DataFormQuestionKey
-
dateAdded(optional):
string(date-time)
The date when the DataFormAnswer object was created or added
-
dateModified(optional):
string(date-time)
The date when the DataFormAnswer object was last modified.
-
defaultAnswer(optional):
boolean
DefaultAnswer of the DataFormAnswer object
-
links(optional):
array links
-
name(optional):
string
Name of the DataFormAnswer object
-
numberValue(optional):
integer
NumberValue of the DataFormAnswer object
-
recordId(optional):
string
The unique record ID of the DataFormAnswer object.
-
referenceKey(optional):
string
The reference key for the DataFormAnswer object. DataFormAnswer objects support multiple languages. This field can be used to identify the associated objects for all languages.
-
sortOrder(optional):
integer
SortOrder of the DataFormAnswer object
object
DataFormQuestionKey
-
links(optional):
array links
-
recordId(optional):
string
The unique record ID of the DataFormQuestion object.
-
referenceKey(optional):
string
The reference key for the DataFormQuestion object. DataFormQuestion objects support multiple languages. This field can be used to identify the associated objects for all languages.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
object
ViewKey
-
links(optional):
array links
-
name(optional):
string
Localized name of the view
-
recordId(optional):
string
GUID of the SITE table containing the view definition
-
referenceKey(optional):
string
Non localized reference key for the view
-
stripeCD(optional):
string
Stripe of a view
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
-
Array of:
object AggregateQuestionResult
Title:
AggregateQuestionResult
object
AggregateQuestionResult
-
answers(optional):
array answers
To Many Relationship to AggregateAnswerResult
-
averageResponse(optional):
number
AverageResponse of the AggregateQuestionResult object
-
name(optional):
string
Localized display name for the Question
-
recordId(optional):
string
The unique record ID of the AggregateQuestionResult object.
-
referenceKey(optional):
string
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(optional):
integer
TotalResponses of the AggregateQuestionResult object
array
-
Array of:
object AggregateAnswerResult
Title:
AggregateAnswerResult
object
AggregateAnswerResult
-
name(optional):
string
Localized display name for the Answer
-
recordId(optional):
string
The unique record ID of the AggregateAnswerResult object.
-
referenceKey(optional):
string
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(optional):
integer
TotalResponses of the AggregateAnswerResult object
object
ReplacementToken
-
dateAdded(optional):
string(date-time)
The date added for the replacement token for the specified locale.
-
dateModified(optional):
string(date-time)
The date modified for the replacement token for the specified locale.
-
links(optional):
array links
-
recordId(optional):
string
The replacement token's record Id.
-
replacementText(optional):
string
The HTML formatted replacement text.
-
replacementTextNonFormatted(optional):
string
The non-HTML formatted replacement text.
-
tokenName(optional):
string
The replacement token's name.
-
tokenType(optional):
string
The token type of the token. Used to specify what kind of text editor was used to create/edit this token: rich text('RICH_TEXT') or plain text('PLAIN_TEXT').
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
Response
- application/json
- application/xml
200 Response
object
Content
-
allTranslations(optional):
array allTranslations
This field will return list of all translated content that the user can view
This field will only be populated if allTranslations query parameter is passed in with value true.
-
answerId(optional):
integer
The unique identifier that enables mapping between an answer and the content.
-
articleStatus(optional):
object ArticleStatusKey
Title:
ArticleStatusKey
-
basedLocale(optional):
object LocaleKey
Title:
LocaleKey
-
basedOnVersion(optional):
string
Version of the Content object
-
categories(optional):
array categories
The Category object or list of Category objects assigned to the Content.
For example. If world is a category at level one, we may have Africa, Uk, America etc. at level two. You can specify requests for objects in a category hierarchically or non- hierarchically. If a content that is assigned Florida is requested using hierarchical request world, you get the result. Whereas, the same request done non- hierarchically gives no result.
The category parameter lets you filter the result by first level category as well as hierarchical category in both single and multiple configurations.
- Match Any
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey eq 'WORLD'&mode=KEY
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey in ('WORLD')&mode=KEY
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey withNoChildren 'WORLD'&mode=KEY
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey inWithNoChildren ('WORLD')&mode=KEY
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey in ('AGILE_CHANNEL', 'NEWS_CHANNEL') and categories.refKey inWithNoChildren ('USA', 'EUROPE')&mode=KEY&orderBy=mostPopular
The following example URIs returns Content objects that match the multiple criterion specified in the request
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey in ('AGILE_CHANNEL', 'NEWS_CHANNEL') and categories.refKey inWithNoChildren ('USA', 'EUROPE') and filterMode.contentState eq 'PUBLISHED'&mode=KEY&orderBy=mostRecent
The objects in the returned list are sorted by the published Date.
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey in ('AGILE_CHANNEL', 'NEWS_CHANNEL') and categories.refKey inWithNoChildren ('USA', 'EUROPE') and filterMode.contentState eq 'LATESTVALID'&mode=KEY&orderBy=mostRecent
The objects in the returned list are sorted by the dateModified.
The service matches any of the category specified in the request if you pass the
contentType.refKey eq
parameter orcontentType.refKey in
parameter with the request.Example URIs for the category parameter are as follows:
OR
The following example URIs returns Content objects which exist at the level of the specified category. This does not return the child Content objects.
OR
The following example URIs returns Content objects that match the multiple criterion specified in the request.
- Match ALL
http://<IM_REST_API_HOST>/km/api/content?q=contentState eq 'LATEST' and contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey matchAll ('WORLD', 'MOVIES')&mode=KEY
The request returns all Content objects in the world and movies category. The service returns a Content object in the category Africa because Africa is a child category for the category world.
http://<IM_REST_API_HOST>/km/api/content?q=contentState eq 'LATEST' and contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey matchAll ('WORLD', 'MOVIES')&mode=KEY&orderBy=mostPopular
The objects in the returned list are sorted by the view in descending order.
http://<IM_REST_API_HOST>/km/api/content?q=contentState eq 'PUBLISHED' and contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey matchAll ('WORLD', 'MOVIES')&mode=KEY&orderBy=mostRecent
The objects in the returned list are sorted by the published date descending order.
The service matches all the categories specified in the request if you pass the
andcategories.refKey matchAll
parameter with the request. -
checkedOut(optional):
boolean
The date when an author has checked out or locked the document for editing.
-
checkedOutBy(optional):
object UserKey
Title:
UserKey
-
contentType(optional):
object ContentTypeKey
Title:
ContentTypeKey
-
createDate(optional):
string(date-time)
The date when the content was created. For legacy systems, the create date is the date when the document was created in those systems.
-
creator(optional):
object UserKey
Title:
UserKey
-
dateAdded(optional):
string(date-time)
The date when the content was added to the content type. For legacy systems, the create date is the date when the document was migrated from the legacy system to the Oracle Knowledge Repository.
-
dateModified(optional):
string(date-time)
The date when the content was last modified in the Oracle Knowledge Repository.
-
displayEndDate(optional):
string(date-time)
The date when the service stops the display of the document to the end users.
-
displayPosition(optional):
Allowed Values:
[ "FIXED_AT_TOP", "PLACE_AT_TOP", "HISTORICAL_USEFULNESS" ]
LookUp code that can be Fixed@Top, Place@Top , Historical Usefulness -
displayReviewDate(optional):
string(date-time)
The date when the document requires a review by an author capable of performing the review.
-
displayStartDate(optional):
string(date-time)
The date when the document will be available to display to end-users.
-
documentId(optional):
string
The unique identifier of a document that indicates the content type in which the content is saved.
-
eventEndDate(optional):
string(date-time)
The date when the document's event ends.
-
eventStartDate(optional):
string(date-time)
The date when the document's event begins.
-
isForEdit(optional):
boolean
The parameter to request editable content.
-
lastModifiedDate(optional):
string(date-time)
The date when the content was last modified. For legacy systems, the lastModifiedDate date is the date when the document was last modified in those systems.
-
lastModifier(optional):
object UserKey
Title:
UserKey
-
latestContent(optional):
object ContentKey
Title:
ContentKey
-
links(optional):
array links
-
locale(optional):
object LocaleKey
Title:
LocaleKey
-
metaDataResourcePath(optional):
string
MetaDataResourcePath of the Content object
-
metaDataXml(optional):
string
MetaDataXml of the Content object
-
owner(optional):
object UserKey
Title:
UserKey
-
pending(optional):
boolean
The flag that indicates whether the document is pending for publication.
-
priority(optional):
Allowed Values:
[ "PRIORITY_0", "PRIORITY_1", "PRIORITY_2", "PRIORITY_3", "PRIORITY_4", "PRIORITY_5", "PRIORITY_6", "PRIORITY_7", "PRIORITY_8", "PRIORITY_9", "PRIORITY_10", "PRIORITY_11", "PRIORITY_12", "PRIORITY_13", "PRIORITY_14", "PRIORITY_15", "PRIORITY_16", "PRIORITY_17", "PRIORITY_18", "PRIORITY_19", "PRIORITY_20" ]
The priority assigned to the content.
The valid values are: PRIORITY_0 to PRIORITY_20. For example, PRIORITY_1 or PRIORITY_18 are valid values, but PRIORITY_21 is not.
-
publishDate(optional):
string(date-time)
The date when the document was first displayed to end users.
-
published(optional):
boolean
The flag that indicates whether the document is published.
-
publishedContent(optional):
object ContentKey
Title:
ContentKey
-
publishedVersion(optional):
string
Version of the Content object
-
rating(optional):
object DataForm
Title:
DataForm
-
ratingsAggregate(optional):
object AggregateFormResults
Title:
AggregateFormResults
-
reasonForEdit(optional):
string
Reasons for editing or creating a content. This will only be used when creating or updating the document.
-
recordId(optional):
string
The unique identifier of the document. This ID is same in all versions in all locales of the document.
-
replacementTokens(optional):
array replacementTokens
The object to create short, manageable terms (the tokenName). These tokens represent standardized, translatable, and sometimes complex content, such as integrated text, images, lists, and tables.
-
resourcePath(optional):
string
EXAMPLE URL : http://<IM_REST_API_HOST>/okcs/resources/{TENANTID}/content/draft/{CONTENTID}/{CONTENTTEXTID}/{FILENAME_WITH_EXTENSION}?login={USER_NAME}. If the user name is not passed then it will be defaulted to 'guest' user.
-
schemaAttributes(optional):
array schemaAttributes
This field will return list of schema attributes associated with the content type of this content.
This field will only be populated if additionalFields query parameter is passed in with value schemaAttributes.
-
title(optional):
string
The tittle of the document.
-
userGroups(optional):
array userGroups
The 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(optional):
string
Version of the Content object
-
versionId(optional):
string
The unique identifier of the specific version of a document in a specific locale. You cannot use this field in queries made using q query parameter.
-
views(optional):
array views
The 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.
-
wfStepNotificationOverride(optional):
string(date-time)
The date when the service sends notification to the author involved in the review. Once the workflow notification is given, the service updates the next review date.
-
workflowStep(optional):
object WorkflowStepKey
Title:
WorkflowStepKey
-
xml(optional):
string
Xml of the Content object
array
This field will return list of all translated content that the user can view
This field will only be populated if allTranslations query parameter is passed in with value true.
-
Array of:
object ContentKey
Title:
ContentKey
object
ArticleStatusKey
-
links(optional):
array links
-
name(optional):
string
The localized name of the ArticleStatus object. The name field can only be used for sorting.
-
recordId(optional):
string
The unique identifier of the ArticleStatus object.
-
referenceKey(optional):
string
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.
object
LocaleKey
-
links(optional):
array links
-
recordId(optional):
string
The unique identifier of the Locale object.
array
The Category object or list of Category objects assigned to the Content.
For example. If world is a category at level one, we may have Africa, Uk, America etc. at level two. You can specify requests for objects in a category hierarchically or non- hierarchically. If a content that is assigned Florida is requested using hierarchical request world, you get the result. Whereas, the same request done non- hierarchically gives no result.
The category parameter lets you filter the result by first level category as well as hierarchical category in both single and multiple configurations.
- Match Any
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey eq 'WORLD'&mode=KEY
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey in ('WORLD')&mode=KEY
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey withNoChildren 'WORLD'&mode=KEY
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey inWithNoChildren ('WORLD')&mode=KEY
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey in ('AGILE_CHANNEL', 'NEWS_CHANNEL') and categories.refKey inWithNoChildren ('USA', 'EUROPE')&mode=KEY&orderBy=mostPopular
The following example URIs returns Content objects that match the multiple criterion specified in the request
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey in ('AGILE_CHANNEL', 'NEWS_CHANNEL') and categories.refKey inWithNoChildren ('USA', 'EUROPE') and filterMode.contentState eq 'PUBLISHED'&mode=KEY&orderBy=mostRecent
The objects in the returned list are sorted by the published Date.
http://<IM_REST_API_HOST>/km/api/content?q=contentType.refKey in ('AGILE_CHANNEL', 'NEWS_CHANNEL') and categories.refKey inWithNoChildren ('USA', 'EUROPE') and filterMode.contentState eq 'LATESTVALID'&mode=KEY&orderBy=mostRecent
The objects in the returned list are sorted by the dateModified.
The service matches any of the category specified in the request if you pass the contentType.refKey eq
parameter or contentType.refKey in
parameter with the request.
Example URIs for the category parameter are as follows:
OR
The following example URIs returns Content objects which exist at the level of the specified category. This does not return the child Content objects.
OR
The following example URIs returns Content objects that match the multiple criterion specified in the request.
- Match ALL
http://<IM_REST_API_HOST>/km/api/content?q=contentState eq 'LATEST' and contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey matchAll ('WORLD', 'MOVIES')&mode=KEY
The request returns all Content objects in the world and movies category. The service returns a Content object in the category Africa because Africa is a child category for the category world.
http://<IM_REST_API_HOST>/km/api/content?q=contentState eq 'LATEST' and contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey matchAll ('WORLD', 'MOVIES')&mode=KEY&orderBy=mostPopular
The objects in the returned list are sorted by the view in descending order.
http://<IM_REST_API_HOST>/km/api/content?q=contentState eq 'PUBLISHED' and contentType.refKey eq 'AGILE_CHANNEL' and categories.refKey matchAll ('WORLD', 'MOVIES')&mode=KEY&orderBy=mostRecent
The objects in the returned list are sorted by the published date descending order.
The service matches all the categories specified in the request if you pass the andcategories.refKey matchAll
parameter with the request.
-
Array of:
object CategoryKey
Title:
CategoryKey
object
UserKey
-
email(optional):
string
Email of the User object
-
externalId(optional):
integer
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.
-
externalType(optional):
string
The ExternalType is the type of the corresponding User from an external system. It, along with ExternalId, can be used to bridge the gap between a User from this system and a User from an external system.
-
links(optional):
array links
-
name(optional):
string
User's full name
-
recordId(optional):
string
The unique record ID of the User object.
object
ContentTypeKey
-
description(optional):
string
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(optional):
array links
-
name(optional):
string
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(optional):
string
The unique identifier of the ContentType object.
-
referenceKey(optional):
string
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(optional):
string
Lookup code that indicates the stripe code.
object
ContentKey
-
allTranslations(optional):
array allTranslations
This field will return list of all translated content that the user can view
This field will only be populated if allTranslations query parameter is passed in with value true.
-
answerId(optional):
integer
The unique identifier that enables mapping between an answer and the content.
-
articleStatus(optional):
object ArticleStatusKey
Title:
ArticleStatusKey
-
dateModified(optional):
string(date-time)
The date when the content was last modified in the Oracle Knowledge Repository.
-
displayEndDate(optional):
string(date-time)
The date when the service stops the display of the document to the end users.
-
displayReviewDate(optional):
string(date-time)
The date when the document requires a review by an author capable of performing the review.
-
displayStartDate(optional):
string(date-time)
The date when the document will be available to display to end-users.
-
documentId(optional):
string
The unique identifier of a document that indicates the content type in which the content is saved.
-
latestContent(optional):
object ContentKey
Title:
ContentKey
-
links(optional):
array links
-
locale(optional):
object LocaleKey
Title:
LocaleKey
-
publishedContent(optional):
object ContentKey
Title:
ContentKey
-
rating(optional):
object DataForm
Title:
DataForm
-
ratingsAggregate(optional):
object AggregateFormResults
Title:
AggregateFormResults
-
recordId(optional):
string
The unique identifier of the document. This ID is same in all versions in all locales of the document.
-
schemaAttributes(optional):
array schemaAttributes
This field will return list of schema attributes associated with the content type of this content.
This field will only be populated if additionalFields query parameter is passed in with value schemaAttributes.
-
title(optional):
string
The tittle of the document.
-
version(optional):
string
Version of the Content object
-
versionId(optional):
string
The unique identifier of the specific version of a document in a specific locale. You cannot use this field in queries made using q query parameter.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
object
DataForm
-
dateAdded(optional):
string(date-time)
The date when the DataForm object was created or added
-
dateModified(optional):
string(date-time)
The date when the DataForm object was last modified.
-
displayEndDate(optional):
string(date-time)
DisplayEndDate of the DataForm object
-
displayStartDate(optional):
string(date-time)
DisplayStartDate of the DataForm object
-
emailContent(optional):
boolean
EmailContent of the DataForm object
-
links(optional):
array links
-
name(optional):
string
The name of the data form. The name field can only be used for sorting.
-
questions(optional):
array questions
To Many Relationship to Question
-
ratingType(optional):
integer
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(optional):
string
The unique record ID of the DataForm object.
-
referenceKey(optional):
string
The reference key for the DataForm object. DataForm objects support multiple languages. This field can be used to identify the associated objects for all languages.
-
user(optional):
object UserKey
Title:
UserKey
-
views(optional):
array views
To Many Relationship to View
object
AggregateFormResults
-
links(optional):
array links
-
questions(optional):
array questions
To Many Relationship to AggregateQuestionResult
-
recordId(optional):
string
The unique record ID of the AggregateFormResults object.
-
referenceKey(optional):
string
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(optional):
integer
TotalResponses of the AggregateFormResults object
array
The object to create short, manageable terms (the tokenName). These tokens represent standardized, translatable, and sometimes complex content, such as integrated text, images, lists, and tables.
-
Array of:
object ReplacementToken
Title:
ReplacementToken
array
This field will return list of schema attributes associated with the content type of this content.
This field will only be populated if additionalFields query parameter is passed in with value schemaAttributes.
-
Array of:
object SchemaAttribute
Title:
SchemaAttribute
array
The user groups assigned to the content. Only the members of the assigned user group will have access to the content. Default value is Everyone.
-
Array of:
object UserGroupKey
Title:
UserGroupKey
array
The 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.
-
Array of:
object ViewKey
Title:
ViewKey
object
WorkflowStepKey
-
links(optional):
array links
-
name(optional):
string
Localized name of the workflow step
-
recordId(optional):
string
GUID from the WORKFLOWSTEP table
-
referenceKey(optional):
string
Non localized name of the workflow step
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
object
-
href:
string
URI [RFC3986] or URI Template [RFC6570]. If the value is set to URI Template, then the "templated" property must be set to true.
-
mediaType(optional):
string
Media type, as defined by RFC 2046, describing the link target.
-
method(optional):
string
HTTP method for requesting the target of the link.
-
profile(optional):
string
Link to the metadata of the resource, such as JSON-schema, that describes the resource expected when dereferencing the target resource..
-
rel:
string
Name of the link relation that, in addition to the type property, can be used to retrieve link details. For example, href or profile.
-
templated(optional):
boolean
Boolean flag that specifies that "href" property is a URI or URI Template. If the property is a URI template, set this value to true. By default, this value is false.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
object
CategoryKey
-
childrenCount(optional):
integer
This field will return number of immediate children a category has.
This field will only be populated if childrenCount query parameter is passed in with value true.
Example URIs for the this parameter are as follows:
- http://<IM_REST_API_HOST>/km/api/categories/{id}?childrenCount=true&mode=KEY
- http://<IM_REST_API_HOST>/km/api/categories?childrenCount=true&mode=KEY
- http://<IM_REST_API_HOST>/km/api/categories?q=contentTypeRefKey eq 'FAQ'&childrenCount=true&mode=KEY
-
description(optional):
string
Description of the Category object
-
externalId(optional):
integer
The unique identifier used while integrating the repository data with the external system.
-
externalType(optional):
string
The type of the category used while integrating the repository data with the external system. Valid options are PRODUCT and CATEGORY.
-
inventoryOrgId(optional):
integer
The inventory organization id of the specific product.
-
links(optional):
array links
-
name(optional):
string
The name of the category.
-
objectId(optional):
string
The hierarchichal position of the category
-
parents(optional):
array parents
This field will return all parents of category.
This field will only be populated if withParents query parameter is passed in with value true.
Example URIs for the this parameter are as follows:
- http://<IM_REST_API_HOST>/km/api/categories/{id}?withParents=true&mode=KEY
- http://<IM_REST_API_HOST>/km/api/categories?withParents=true&mode=KEY
- http://<IM_REST_API_HOST>/km/api/categories?q=contentTypeRefKey eq 'FAQ'&withParents=true&mode=KEY
- http://<IM_REST_API_HOST>/km/api/categories/{id}?childrenCount=true&withParents=true&mode=KEY
-
recordId(optional):
string
The unique record ID of the Category object.
-
referenceKey(optional):
string
The reference key for the Category object. Category objects support multiple languages. This field can be used to identify the associated objects for all languages.
-
responseLocale(optional):
string
This is a custom field that will get populated if a name is translated into the default locale when the translated name is not found.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
This field will return all parents of category.
This field will only be populated if withParents query parameter is passed in with value true.
Example URIs for the this parameter are as follows:
- http://<IM_REST_API_HOST>/km/api/categories/{id}?withParents=true&mode=KEY
- http://<IM_REST_API_HOST>/km/api/categories?withParents=true&mode=KEY
- http://<IM_REST_API_HOST>/km/api/categories?q=contentTypeRefKey eq 'FAQ'&withParents=true&mode=KEY
- http://<IM_REST_API_HOST>/km/api/categories/{id}?childrenCount=true&withParents=true&mode=KEY
-
Array of:
object CategoryKey
Title:
CategoryKey
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
This field will return list of all translated content that the user can view
This field will only be populated if allTranslations query parameter is passed in with value true.
-
Array of:
object ContentKey
Title:
ContentKey
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
This field will return list of schema attributes associated with the content type of this content.
This field will only be populated if additionalFields query parameter is passed in with value schemaAttributes.
-
Array of:
object SchemaAttribute
Title:
SchemaAttribute
object
SchemaAttribute
-
allowMultipleNodes(optional):
boolean
Flag indicating if multiple nodes are allowed of this type @since 8.3
-
allowPreselectedUserGroupChange(optional):
boolean
Enable editors to modify preselected user group restrictions @since 8.3
-
children(optional):
array children
List of child nodes of the current element
-
counter(optional):
integer
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(optional):
string
This attribute contains the prefix that is appended to the front of the DOC ID counter
-
dateAdded(optional):
string(date-time)
This attribute represents the timestamp when the SchemaAttribute definition was first created
-
dateModified(optional):
string(date-time)
This attribute represents the timestamp when the SchemaAttribute definition was last modified
-
description(optional):
string
Localized help text for the attribute. This text is displayed in the authoring view
-
enableAttributeLevelSearch(optional):
boolean
Flag indicating whether this field should be configured for attribute level searching - i.e. where TITLE='xyz'. This field was previously called searchable @since 8.3
-
enableFullTextSearch(optional):
boolean
Flag indicating whether this field should be included in the full text index. This field was previously called indexable @since 8.3
-
includeInMasterIdentifier(optional):
boolean
Flag indicating whether this field should be appended to the master identifier of the document
-
isNode(optional):
boolean
Flag indicating if this element is a node @since 8.3
-
isRequired(optional):
boolean
Make attribute a required field @since 8.3
-
links(optional):
array links
-
localizedAttributes(optional):
array localizedAttributes
List of LocalizedAttributes of this SchemaAttribute name and description in various Locales
-
name(optional):
string
Localized name of the attribute. This need NOT be unique within the Schema.
-
readOnly(optional):
boolean
Flag indicating whether this field is editable
-
recordId(optional):
string
Unique identifier for the SchemaAttribute object
-
referenceKey(optional):
string
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(optional):
boolean
Attribute requires workflow approval if workflow is enabled
-
schemaAttributeUserGroupList(optional):
array schemaAttributeUserGroupList
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(optional):
Allowed Values:
[ "TEXT_AREA", "WYSIWYG_EDIT", "TEXT_FIELD", "FILE", "BOOLEAN", "LIST", "COUNTER", "DATE", "DATETIME", "TIME", "INTEGER", "FLOAT" ]
Enumerated type representing the type of attribute - i.e. text field, rich text area -
securedFileResource(optional):
boolean
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(optional):
boolean
Restrict attribute to selected user groups
-
securityRegex(optional):
string
The regular expression used to validate the field against security attacks.
-
sortOrder(optional):
integer
Display order of the schema attributes within the edit form
-
textHeight(optional):
string
Specifies the text height for text areas and rich text fields
-
textWidth(optional):
string
Specifies the max length for text fields
-
userGroupSelectionRequired(optional):
boolean
User groups are required for attribute
-
wysiwygType(optional):
Allowed Values:
[ "BASIC", "MEDIUM", "FULL" ]
Type of WYSIWYG rich text field - i.e. FULL, BASIC, MEDIUM @since 8.3 -
xpath(optional):
string
The XPATH of this attribute within the schema. This is unique within the Schema.
array
-
Array of:
object SchemaAttribute
Title:
SchemaAttribute
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
-
Array of:
object LocalizedAttributes
Title:
LocalizedAttributes
array
-
Array of:
object SchemaAttributeUserGroup
Title:
SchemaAttributeUserGroup
object
LocalizedAttributes
-
description(optional):
string
Localized description in the above Locale
-
localeId(optional):
string
RecordId of the Locale - generally this is the localeCode (like en_US) and NOT a real GUID.
-
name(optional):
string
Localized Name in the above Locale
object
SchemaAttributeUserGroup
-
defaultValue(optional):
boolean
Flag indiacting whether the user group should be selected by default
-
recordId(optional):
string
GUID from the XMLSCHEMAATTRIBUTEUSERGROUP table
-
userGroup(optional):
object UserGroupKey
Title:
UserGroupKey
object
UserGroupKey
-
externalId(optional):
integer
The unique identifier of the corresponding userGroup from an external system. You can use the External ID with the ExternalType parameter to connect user groups in the internal and the the external systems.
-
externalType(optional):
string
The ExternalType is the type of the corresponding userGroup from an external system.
-
links(optional):
array links
-
name(optional):
string
The localized name of the user group. The name field can only be used for sorting.
-
recordId(optional):
string
The unique identifier from the TAG table that represent a userGroups resource
-
referenceKey(optional):
string
The non localized name of the user group
-
stripeCD(optional):
string
Stripe for UserGroup
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
-
Array of:
object DataFormQuestion
Title:
DataFormQuestion
array
-
Array of:
object ViewKey
Title:
ViewKey
object
DataFormQuestion
-
answers(optional):
array answers
To Many Relationship to Answer
-
dataForm(optional):
object DataFormKey
Title:
DataFormKey
-
dateAdded(optional):
string(date-time)
The date when the DataFormQuestion object was created or added
-
dateModified(optional):
string(date-time)
The date when the DataFormQuestion object was last modified.
-
isMasterIdentifier(optional):
boolean
IsMasterIdentifier of the DataFormQuestion object
-
links(optional):
array links
-
name(optional):
string
Name of the DataFormQuestion object
-
recordId(optional):
string
The unique record ID of the DataFormQuestion object.
-
referenceKey(optional):
string
The reference key for the DataFormQuestion object. DataFormQuestion objects support multiple languages. This field can be used to identify the associated objects for all languages.
-
required(optional):
boolean
Required of the DataFormQuestion object
-
sortOrder(optional):
integer
SortOrder of the DataFormQuestion object
-
specialTypeIndicator(optional):
integer
SpecialTypeIndicator of the DataFormQuestion object
array
-
Array of:
object DataFormAnswer
Title:
DataFormAnswer
object
DataFormKey
-
links(optional):
array links
-
recordId(optional):
string
The unique record ID of the DataForm object.
-
referenceKey(optional):
string
The reference key for the DataForm object. DataForm objects support multiple languages. This field can be used to identify the associated objects for all languages.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
object
DataFormAnswer
-
dataFormQuestion(optional):
object DataFormQuestionKey
Title:
DataFormQuestionKey
-
dateAdded(optional):
string(date-time)
The date when the DataFormAnswer object was created or added
-
dateModified(optional):
string(date-time)
The date when the DataFormAnswer object was last modified.
-
defaultAnswer(optional):
boolean
DefaultAnswer of the DataFormAnswer object
-
links(optional):
array links
-
name(optional):
string
Name of the DataFormAnswer object
-
numberValue(optional):
integer
NumberValue of the DataFormAnswer object
-
recordId(optional):
string
The unique record ID of the DataFormAnswer object.
-
referenceKey(optional):
string
The reference key for the DataFormAnswer object. DataFormAnswer objects support multiple languages. This field can be used to identify the associated objects for all languages.
-
sortOrder(optional):
integer
SortOrder of the DataFormAnswer object
object
DataFormQuestionKey
-
links(optional):
array links
-
recordId(optional):
string
The unique record ID of the DataFormQuestion object.
-
referenceKey(optional):
string
The reference key for the DataFormQuestion object. DataFormQuestion objects support multiple languages. This field can be used to identify the associated objects for all languages.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
object
ViewKey
-
links(optional):
array links
-
name(optional):
string
Localized name of the view
-
recordId(optional):
string
GUID of the SITE table containing the view definition
-
referenceKey(optional):
string
Non localized reference key for the view
-
stripeCD(optional):
string
Stripe of a view
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
-
Array of:
object AggregateQuestionResult
Title:
AggregateQuestionResult
object
AggregateQuestionResult
-
answers(optional):
array answers
To Many Relationship to AggregateAnswerResult
-
averageResponse(optional):
number
AverageResponse of the AggregateQuestionResult object
-
name(optional):
string
Localized display name for the Question
-
recordId(optional):
string
The unique record ID of the AggregateQuestionResult object.
-
referenceKey(optional):
string
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(optional):
integer
TotalResponses of the AggregateQuestionResult object
array
-
Array of:
object AggregateAnswerResult
Title:
AggregateAnswerResult
object
AggregateAnswerResult
-
name(optional):
string
Localized display name for the Answer
-
recordId(optional):
string
The unique record ID of the AggregateAnswerResult object.
-
referenceKey(optional):
string
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(optional):
integer
TotalResponses of the AggregateAnswerResult object
object
ReplacementToken
-
dateAdded(optional):
string(date-time)
The date added for the replacement token for the specified locale.
-
dateModified(optional):
string(date-time)
The date modified for the replacement token for the specified locale.
-
links(optional):
array links
-
recordId(optional):
string
The replacement token's record Id.
-
replacementText(optional):
string
The HTML formatted replacement text.
-
replacementTextNonFormatted(optional):
string
The non-HTML formatted replacement text.
-
tokenName(optional):
string
The replacement token's name.
-
tokenType(optional):
string
The token type of the token. Used to specify what kind of text editor was used to create/edit this token: rich text('RICH_TEXT') or plain text('PLAIN_TEXT').
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
Examples
The following example shows how to update content in the master locale or any other locale to which content is already translated:
curl -X PUT "https://<IM_REST_API_HOST>/km/api/latest/content/{id}" -u "<username:password>" -H "Accept: application/json" -H "Content-Type: application/json" -d "@<FilePath/RequestBody.json>"
Example of Request Body
The following shows an example of the request body in JSON format.
{ "isForEdit": true, "categories": [], "userGroups": [], "views": [ { "recordId": "BBA181DFB52148779A416184A191B2AF", "referenceKey": "SERVICE", "name": "Service", "links": [ { "rel": "canonical", "href": "https://<IM_REST_API_HOST>/km/api/latest/views/BBA181DFB52148779A416184A191B2AF", "mediaType": "application/json, application/xml", "method": "GET" } ] } ], "recordId": "55139CC10D70461B8657C239D641FC52", "versionId": "EABCAD3CEF3241E6AF69AF39F7C3CD01", "documentId": "FAQ14", "version":"1.0", "locale": { "recordId": "en_US", "links": [ { "rel": "canonical", "href": "https://<IM_REST_API_HOST>/km/api/latest/locales/en_US", "mediaType": "application/json, application/xml", "method": "GET" } ] }, "dateModified": "2018-11-26T13:45:56+0530", "contentType": { "recordId": "98055D055BA8467B8097FB0B52923FD2", "referenceKey": "FAQ", "name": "FAQ", "description": "A template containing a common question and answer on a specific topic", "links": [ { "rel": "canonical", "href": "https://<IM_REST_API_HOST>/km/api/latest/contentTypes/98055D055BA8467B8097FB0B52923FD2", "mediaType": "application/json, application/xml", "method": "GET" } ] }, "priority": "PRIORITY_0", "createDate": "2018-11-26T13:45:03+0530", "dateAdded": "2018-11-26T13:45:03+0530", "owner": { "recordId": 2, "name": "Default Administrator", "email": "user@example.com", "externalType": "ACCOUNT", "links": [ { "rel": "canonical", "href": "https://<IM_REST_API_HOST>/km/api/latest/users/2", "mediaType": "application/json, application/xml", "method": "GET" } ] }, "published": false, "pending": false, "checkedOut": false, "xml": "<FAQ><QUESTION><![CDATA[Q query Testing-upd]]></QUESTION><ANSWER><![CDATA[Q query Testing-upd]]></ANSWER><SUMMARY><![CDATA[Q query Testing-upd]]></SUMMARY></FAQ>" }
Example of Response Body
The following shows an example of the response body in JSON format.
{ "isForEdit": true, "categories": [], "userGroups": [], "views": [ { "recordId": "BBA181DFB52148779A416184A191B2AF", "referenceKey": "SERVICE", "name": "Service", "links": [ { "rel": "canonical", "href": "https://<IM_REST_API_HOST>/km/api/latest/views/BBA181DFB52148779A416184A191B2AF", "mediaType": "application/json, application/xml", "method": "GET" } ] } ], "recordId": "55139CC10D70461B8657C239D641FC52", "versionId": "1A6E0737C6934364928964ABBDF6E862", "documentId": "FAQ14", "title": "Q query Testing-upd", "version": "2.0", "answerId": 1001005, "locale": { "recordId": "en_US", "links": [ { "rel": "canonical", "href": "https://<IM_REST_API_HOST>/km/api/latest/locales/en_US", "mediaType": "application/json, application/xml", "method": "GET" } ] }, "dateModified": "2018-11-26T13:59:54+0530", "links": [ { "rel": "canonical", "href": "https://<IM_REST_API_HOST>/km/api/latest/content/55139CC10D70461B8657C239D641FC52", "mediaType": "application/json, application/xml", "method": "GET" }, { "rel": "collection", "href": "https://<IM_REST_API_HOST>/km/api/latest/content", "mediaType": "application/json, application/xml", "method": "GET", "profile": "https://<IM_REST_API_HOST>/km/api/latest/metadata-catalog/content" } ], "contentType": { "recordId": "98055D055BA8467B8097FB0B52923FD2", "referenceKey": "FAQ", "name": "FAQ", "description": "A simple template containing a common question and answer on a specific topic", "links": [ { "rel": "canonical", "href": "https://<IM_REST_API_HOST>/km/api/latest/contentTypes/98055D055BA8467B8097FB0B52923FD2", "mediaType": "application/json, application/xml", "method": "GET" } ] }, "priority": "PRIORITY_0", "createDate": "2018-11-26T13:45:03+0530", "lastModifiedDate": "2018-11-26T13:59:54+0530", "dateAdded": "2018-11-26T13:59:54+0530", "displayStartDate": "1900-01-01T00:00:00+0530", "displayEndDate": "9999-12-31T00:00:00+0530", "owner": { "recordId": 2, "name": "Default Administrator", "email": "user@example.com", "externalType": "ACCOUNT", "links": [ { "rel": "canonical", "href": "https://<IM_REST_API_HOST>/km/api/latest/users/2", "mediaType": "application/json, application/xml", "method": "GET" } ] }, "lastModifier": { "recordId": 2, "name": "Default Administrator", "email": "user@example.com", "externalType": "ACCOUNT", "links": [ { "rel": "canonical", "href": "https://<IM_REST_API_HOST>/km/api/latest/users/2", "mediaType": "application/json, application/xml", "method": "GET" } ] }, "creator": { "recordId": 2, "name": "Default Administrator", "email": "user@example.com", "externalType": "ACCOUNT", "links": [ { "rel": "canonical", "href": "https://<IM_REST_API_HOST>/km/api/latest/users/2", "mediaType": "application/json, application/xml", "method": "GET" } ] }, "published": false, "pending": false, "checkedOut": false, "publishedVersion": "1.0", "xml": "<FAQ><QUESTION><![CDATA[Q query Testing-upd]]></QUESTION><ANSWER><![CDATA[Q query Testing-upd]]></ANSWER><SUMMARY><![CDATA[Q query Testing-upd]]></SUMMARY></FAQ>", "resourcePath": "$STAGING_RESOURCE_HOST_URL/fusion/content/draft/55139CC10D70461B8657C239D641FC52/1A6E0737C6934364928964ABBDF6E862/" }