Update an answer version
patch
/services/rest/connect/v1.4/answerVersions/{id}
Request
Path Parameters
-
id(required): integer
The unique identifier of the answer version.
The versioned instance of an answer. Answers are solutions to common customer support questions. These questions and answers are maintained in the Oracle B2C Service knowledge base.
Root Schema : answerVersions
Type:
objectThe versioned instance of an answer. Answers are solutions to common customer support questions. These questions and answers are maintained in the Oracle B2C Service knowledge base.
Show Source
-
accessLevels:
object namedIDs-answerVersions-accessLevels
The named ID that can be included in a list.
-
adminLastAccessTime:
[
"string",
"null"
]
The date and time when the answer version was last accessed by an administrator. This attribute is read-only.
-
answer:
object answer
The knowledge base information that provides solutions to the common customer support questions. It is the reference to a resource in 'answers' collection. Only ID or lookupName can be provided to specify the resource.
-
answerType:
object namedIDs-answerVersions-answerType
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
-
assignedTo:
object answerVersions-assignedTo
The collection of staff account and staff group.
-
banner:
object answerVersions-banner
The display flags of a banner.
-
categories:
array categories
The hierarchical service category that provides an option to group answers and incidents for better organization and refined searching in the knowledge base. It is the reference to a resource in 'serviceCategories' collection. Only ID or lookupName can be provided to specify the resources.
-
commonAttachments:
object answerVersions-commonAttachments
The file attachment shared by sibling answers.
-
createdTime:
string
The date and time when the answer version was created. This attribute is read-only.
-
expiresDate:
[
"string",
"null"
]
The date when the answer version expires and is set to review status.
-
fileAttachments:
object answerVersions-fileAttachments
The file attachment shared by answers.
-
guidedAssistance:
object namedIDs-answerVersions-guidedAssistance
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
-
id:
integer
Minimum Value:
1Maximum Value:9223372036854776000The unique identifier of the answer version. -
keywords:
[
"string",
"null"
]
Maximum Length:
1333The list of space separated keywords associated with an answer version. -
language:
object namedIDs-answerVersions-language
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
-
lastAccessTime:
[
"string",
"null"
]
The date and time when the answer version was last accessed. This attribute is read-only.
-
lastNotificationTime:
[
"string",
"null"
]
The date and time when the last notification was generated. This attribute is read-only.
-
lookupName:
string
Maximum Length:
255The name used to look up the answer version. -
name:
string
Maximum Length:
20The string version of the answer ID, which is used as the reference number of the answer version. This attribute is read-only. -
nextNotificationTime:
[
"string",
"null"
]
The date and time when the next notification will be sent.
-
notes:
object answerVersions-notes
The note text associated with the objects such as contacts and organizations.
-
originalReferenceNumber:
[
"string",
"null"
]
Maximum Length:
13Pattern:^[0-9]{2}[0|1][0-9][0-3][0-9]\-[0-9]{6}$The reference number of the incident that was proposed to create this answer. The reference number is common for all the sibling answers. -
positionInList:
object namedIDs-answerVersions-positionInList
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
-
products:
array products
The hierarchical service product that provides an option to group answers and incidents for better organization and refined searching in the knowledge base. It is the reference to a resource in 'serviceProducts' collection. Only ID or lookupName can be provided to specify the resources.
-
publishOnDate:
[
"string",
"null"
]
The date when the answer version will be published and made available to users.
-
question:
[
"string",
"null"
]
Maximum Length:
1048576The question or the description of the answer version. - relatedAnswers: object answerVersions-relatedAnswers
-
solution:
[
"string",
"null"
]
Maximum Length:
1048576The solution or the answer portion of this version of the answer. -
specialResponse:
[
"string",
"null"
]
Maximum Length:
1048576The special response of this version of the answer. -
statusWithType:
object answerVersions-statusWithType
The status of an object with its associated status type.
-
summary:
string
Maximum Length:
240The title or short summary of the answer version. -
updatedByAccount:
[
"object",
"null"
]
The account represents a staff member in Oracle B2C Service. Examples of staff members are customer sales representatives, sales agents, site administrators, and so on. It is the reference to a resource in 'accounts' collection. Only ID or lookupName can be provided to specify the resource.
-
updatedTime:
string
The date and time when the answer version was last updated. This attribute is read-only.
-
uRL:
[
"string",
"null"
]
Maximum Length:
1333The URL which returns this version of the answer, if the answer type is URL. -
versionDetail:
object answerVersions-versionDetail
The details of the answer version.
Nested Schema : namedIDs-answerVersions-accessLevels
Type:
objectThe named ID that can be included in a list.
Show Source
-
id:
integer
Minimum Value:
1Maximum Value:9223372036854776000The unique identifier of the access level. -
lookupName:
string
Maximum Length:
255The name used to look up the access level.
Nested Schema : answer
Type:
objectThe knowledge base information that provides solutions to the common customer support questions. It is the reference to a resource in 'answers' collection. Only ID or lookupName can be provided to specify the resource.
Nested Schema : namedIDs-answerVersions-answerType
Type:
objectAn ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
-
id:
integer
Minimum Value:
0ID value -
lookupName:
string
Maximum Length:
255Name used to lookup this object
Nested Schema : answerVersions-assignedTo
Type:
objectThe collection of staff account and staff group.
Show Source
-
account:
[
"object",
"null"
]
The account represents a staff member in Oracle B2C Service. Examples of staff members are customer sales representatives, sales agents, site administrators, and so on. It is the reference to a resource in 'accounts' collection. Only ID or lookupName can be provided to specify the resource.
-
staffGroup:
object namedIDs-answerVersions-assignedTo-staffGroup
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Nested Schema : categories
Type:
arrayThe hierarchical service category that provides an option to group answers and incidents for better organization and refined searching in the knowledge base. It is the reference to a resource in 'serviceCategories' collection. Only ID or lookupName can be provided to specify the resources.
Show Source
Nested Schema : answerVersions-commonAttachments
Type:
objectThe file attachment shared by sibling answers.
Show Source
-
contentType:
string
Maximum Length:
128Pattern:^[a-zA-Z-]+/[-a-zA-Z0-9.+_*]+$The MIME content type of the file. For example, text/plain, audio/mp3, image/jpg, and so on. -
createdTime:
string
The date and time when the file was associated with the answer. This attribute is read-only.
-
data:
string
The Base64 encoded data contained in the file. The maximum supported length is defined by the maximum number of bytes allowed by this field.
-
disabled:
boolean
Indicates whether the file attachment is hidden when the associated answer is viewed. If the Private flag is not set, this flag hides the file attachment. This attribute does not have a default value.
-
fileName:
string
Maximum Length:
100Pattern:^[^ \/:*?"<>|]*$The name of the file when saving it to the disk. -
formData:
string
-
id:
integer
Minimum Value:
1Maximum Value:9223372036854776000The unique identifier of the file attachment. -
names:
object answerVersions-commonAttachments-names
The language-specific strings used for localization of fields. The label text cannot be empty or null. The labels are assembled in a list associated with a particular text field.
-
private:
boolean
Indicates whether the file attachment is hidden from the end users. This attribute does not have a default value.
-
size:
integer
Minimum Value:
1Maximum Value:2147483647The size of the file in bytes. This attribute is read-only. -
updatedTime:
[
"string",
"null"
]
The date and time when the file was last updated. This attribute is read-only.
-
uRL:
string
Maximum Length:
1333The URL to access this file.
Nested Schema : answerVersions-fileAttachments
Type:
objectThe file attachment shared by answers.
Show Source
-
contentType:
string
Maximum Length:
128Pattern:^[a-zA-Z-]+/[-a-zA-Z0-9.+_*]+$The MIME content type of the file. For example, text/plain, audio/mp3, image/jpg, and so on. -
createdTime:
string
The date and time when the file was associated with the answer. This attribute is read-only.
-
data:
string
The Base64 encoded data contained in the file. The maximum supported length is defined by the maximum number of bytes allowed by this field.
-
description:
string
Maximum Length:
1333The description for the contents of the file attachment. -
disabled:
boolean
Indicates whether the file attachment should be hidden when the associated answer is viewed. If the Private flag is not set, this flag hides the file attachment. This attribute does not have a default value.
-
fileName:
string
Maximum Length:
100Pattern:^[^ \/:*?"<>|]*$The name of the file when saving it to the disk. -
formData:
string
The HTML form which is used to upload file attachments.
-
id:
integer
Minimum Value:
1Maximum Value:9223372036854776000The unique identifier of the file attachment. -
indexed:
boolean
Indicates whether the file attachment's contents are included in the keyword indexing of the answer. This attribute does not have a default value.
-
name:
string
Maximum Length:
40Pattern:^[^ ]*$The short display name of the file attachment. -
private:
boolean
Indicates whether the file attachment is hidden from the end users. The default value is false.
-
size:
integer
Minimum Value:
1Maximum Value:2147483647The size of the file in bytes. This attribute is read-only. -
updatedTime:
[
"string",
"null"
]
The date and time when the file was last updated. This attribute is read-only.
-
uRL:
string
Maximum Length:
1333The URL to access the file.
Nested Schema : namedIDs-answerVersions-guidedAssistance
Type:
objectAn ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
-
id:
integer
Minimum Value:
0ID value -
lookupName:
string
Maximum Length:
255Name used to lookup this object
Nested Schema : namedIDs-answerVersions-language
Type:
objectAn ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
-
id:
integer
Minimum Value:
0ID value -
lookupName:
string
Maximum Length:
255Name used to lookup this object
Nested Schema : answerVersions-notes
Type:
objectThe note text associated with the objects such as contacts and organizations.
Show Source
-
channel:
object namedIDs-answerVersions-notes-channel
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
-
createdByAccount:
[
"object",
"null"
]
The account represents a staff member in Oracle B2C Service. Examples of staff members are customer sales representatives, sales agents, site administrators, and so on. It is the reference to a resource in 'accounts' collection. Only ID or lookupName can be provided to specify the resource.
-
createdTime:
string
The date and time when the note was created. This attribute is read-only.
-
id:
integer
Minimum Value:
1Maximum Value:9223372036854776000The unique identifier of the note. -
text:
string
Maximum Length:
349525The text content in the note. -
updatedByAccount:
[
"object",
"null"
]
The account represents a staff member in Oracle B2C Service. Examples of staff members are customer sales representatives, sales agents, site administrators, and so on. It is the reference to a resource in 'accounts' collection. Only ID or lookupName can be provided to specify the resource.
-
updatedTime:
string
The date and time when the note was last updated. This attribute is read-only.
Nested Schema : namedIDs-answerVersions-positionInList
Type:
objectAn ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
-
id:
integer
Minimum Value:
0ID value -
lookupName:
string
Maximum Length:
255Name used to lookup this object
Nested Schema : products
Type:
arrayThe hierarchical service product that provides an option to group answers and incidents for better organization and refined searching in the knowledge base. It is the reference to a resource in 'serviceProducts' collection. Only ID or lookupName can be provided to specify the resources.
Show Source
Nested Schema : answerVersions-statusWithType
Type:
objectThe status of an object with its associated status type.
Show Source
-
status:
object namedIDs-answerVersions-statusWithType-status
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
-
statusType:
object namedIDs-answerVersions-statusWithType-statusType
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Nested Schema : answerVersions-versionDetail
Type:
objectThe details of the answer version.
Show Source
-
draftNote:
[
"string",
"null"
]
Maximum Length:
1333The draft note for the answer version. -
draftTime:
string
The date and time when the draft answer version was created.
-
publishedTime:
[
"string",
"null"
]
The date and time when the draft answer version was published.
-
publishNote:
[
"string",
"null"
]
Maximum Length:
1333The published note for the answer version. -
state:
object namedIDs-answerVersions-versionDetail-state
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
-
unpublishedTime:
[
"string",
"null"
]
The date and time when the answer version was unpublished.
Nested Schema : namedIDs-answerVersions-assignedTo-staffGroup
Type:
objectAn ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
-
id:
integer
Minimum Value:
0ID value -
lookupName:
string
Maximum Length:
255Name used to lookup this object
Nested Schema : items
Type:
objectNested Schema : answerVersions-commonAttachments-names
Type:
objectThe language-specific strings used for localization of fields. The label text cannot be empty or null. The labels are assembled in a list associated with a particular text field.
Show Source
-
labelText:
string
Maximum Length:
80The language-specific label text. The value cannot be null or empty. -
language:
object namedIDs-answerVersions-commonAttachments-names-language
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Nested Schema : namedIDs-answerVersions-commonAttachments-names-language
Type:
objectAn ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
-
id:
integer
Minimum Value:
0ID value -
lookupName:
string
Maximum Length:
255Name used to lookup this object
Nested Schema : namedIDs-answerVersions-notes-channel
Type:
objectAn ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
-
id:
integer
Minimum Value:
0ID value -
lookupName:
string
Maximum Length:
255Name used to lookup this object
Nested Schema : items
Type:
objectNested Schema : namedIDs-answerVersions-statusWithType-status
Type:
objectAn ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
-
id:
integer
Minimum Value:
0ID value -
lookupName:
string
Maximum Length:
255Name used to lookup this object
Nested Schema : namedIDs-answerVersions-statusWithType-statusType
Type:
objectAn ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
-
id:
integer
Minimum Value:
0ID value -
lookupName:
string
Maximum Length:
255Name used to lookup this object
Nested Schema : namedIDs-answerVersions-versionDetail-state
Type:
objectAn ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
-
id:
integer
Minimum Value:
0ID value -
lookupName:
string
Maximum Length:
255Name used to lookup this object