Create an answer
post
/services/rest/connect/v1.4/answers
Request
The knowledge base information that provides solutions to the common customer support questions.
Root Schema : answers
Type:
object
The knowledge base information that provides solutions to the common customer support questions.
Show Source
-
accessLevels(optional):
object namedIDs-answers-accessLevels
The named ID that can be included in a list.
-
adminLastAccessTime(optional):
[
"string",
"null"
]
The date and time when the answer was last accessed by an administrator. This attribute is read-only.
-
answerType(optional):
object namedIDs-answerTypes
The type of an answer.
-
answerVersion(optional):
object answerVersion
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. It is the reference to a resource in 'answerVersions' collection. Only ID or lookupName can be provided to specify the resource.
-
assignedSibling(optional):
[
"object",
"null"
]
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.
-
assignedTo(optional):
object answers-assignedTo
The collection of staff account and staff group.
-
banner(optional):
object answers-banner
The display flags of a banner.
-
categories(optional):
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(optional):
object answers-commonAttachments
The file attachment shared by sibling answers.
-
createdTime(optional):
string
The date and time when the answer was created. This attribute is read-only.
-
expiresDate(optional):
[
"string",
"null"
]
The date when the answer expires and is set to review status.
-
fileAttachments(optional):
object answers-fileAttachments
The file attachment shared by answers.
-
guidedAssistance(optional):
object namedIDs-answers-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(optional):
integer
Minimum Value:
1
Maximum Value:9.223372036854776E18
The unique identifier of the answer. -
keywords(optional):
[
"string",
"null"
]
Maximum Length:
1333
The list of space separated keywords associated with an answer. -
language(optional):
object namedIDs-answers-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(optional):
[
"string",
"null"
]
The date and time when the answer was last accessed. This attribute is read-only.
-
lastNotificationTime(optional):
[
"string",
"null"
]
The date and time when the last notification was generated. This attribute is read-only.
-
lookupName(optional):
string
Maximum Length:
255
The name used to look up the answer. -
name(optional):
string
Maximum Length:
20
The string version of the answer ID, which is used as the reference number of the answer. This attribute is read-only. -
nextNotificationTime(optional):
[
"string",
"null"
]
The date and time when the next earliest notification will be sent.
-
notes(optional):
object answers-notes
The note text associated with the objects such as contacts and organizations.
-
originalReferenceNumber(optional):
[
"string",
"null"
]
Maximum Length:
13
Pattern:^[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(optional):
object namedIDs-answers-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(optional):
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(optional):
[
"string",
"null"
]
The date when the answer will be published and made available to users.
-
question(optional):
[
"string",
"null"
]
Maximum Length:
1048576
The question or the description of the answer. - relatedAnswers(optional): object answers-relatedAnswers
-
siblingAnswers(optional):
array siblingAnswers
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 resources.
-
solution(optional):
[
"string",
"null"
]
Maximum Length:
1048576
The solution or the answer portion of the answer. -
specialResponse(optional):
[
"string",
"null"
]
Maximum Length:
1048576
The special response of the answer. -
statusWithType(optional):
object answers-statusWithType
The status of an object with its associated status type.
-
summary(optional):
string
Maximum Length:
240
The title or short summary of the answer. -
updatedByAccount(optional):
[
"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(optional):
string
The date and time when the answer was last updated. This attribute is read-only.
-
uRL(optional):
[
"string",
"null"
]
Maximum Length:
1333
The URL which returns the answer, if the answer type is URL. -
versionDetail(optional):
object answers-versionDetail
The details of the answer version.
Nested Schema : namedIDs-answers-accessLevels
Type:
object
The named ID that can be included in a list.
Show Source
-
id(optional):
integer
Minimum Value:
1
Maximum Value:9.223372036854776E18
The unique identifier of the access level. -
lookupName(optional):
string
Maximum Length:
255
The name used to look up the access level.
Nested Schema : namedIDs-answerTypes
Type:
object
The type of an answer.
Show Source
-
id(optional):
integer
Minimum Value:
1
Maximum Value:9.223372036854776E18
The unique identifier of the answer type. -
lookupName(optional):
string
Maximum Length:
255
The name used to look up the answer type.
Nested Schema : answerVersion
Type:
object
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. It is the reference to a resource in 'answerVersions' collection. Only ID or lookupName can be provided to specify the resource.
Nested Schema : answers-assignedTo
Type:
object
The collection of staff account and staff group.
Show Source
-
account(optional):
[
"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(optional):
object namedIDs-answers-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:
array
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.
Show Source
Nested Schema : answers-commonAttachments
Type:
object
The file attachment shared by sibling answers.
Show Source
-
contentType(optional):
string
Maximum Length:
128
Pattern:^[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(optional):
string
The date and time when the file was associated with the answer. This attribute is read-only.
-
data(optional):
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(optional):
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(optional):
string
Maximum Length:
100
Pattern:^[^ \/:*?"<>|]*$
The name of the file when saving it to the disk. -
formData(optional):
string
-
id(optional):
integer
Minimum Value:
1
Maximum Value:9.223372036854776E18
The unique identifier of the file attachment. -
names(optional):
object answers-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(optional):
boolean
Indicates whether the file attachment is hidden from the end users. This attribute does not have a default value.
-
size(optional):
integer
Minimum Value:
1
Maximum Value:2147483647
The size of the file in bytes. This attribute is read-only. -
updatedTime(optional):
[
"string",
"null"
]
The date and time when the file was last updated. This attribute is read-only.
-
uRL(optional):
string
Maximum Length:
1333
The URL to access this file.
Nested Schema : answers-fileAttachments
Type:
object
The file attachment shared by answers.
Show Source
-
contentType(optional):
string
Maximum Length:
128
Pattern:^[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(optional):
string
The date and time when the file was associated with the answer. This attribute is read-only.
-
data(optional):
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(optional):
string
Maximum Length:
1333
The description for the contents of the file attachment. -
disabled(optional):
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(optional):
string
Maximum Length:
100
Pattern:^[^ \/:*?"<>|]*$
The name of the file when saving it to the disk. -
formData(optional):
string
The HTML form which is used to upload file attachments.
-
id(optional):
integer
Minimum Value:
1
Maximum Value:9.223372036854776E18
The unique identifier of the file attachment. -
indexed(optional):
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(optional):
string
Maximum Length:
40
Pattern:^[^ ]*$
The short display name of the file attachment. -
private(optional):
boolean
Indicates whether the file attachment is hidden from the end users. The default value is false.
-
size(optional):
integer
Minimum Value:
1
Maximum Value:2147483647
The size of the file in bytes. This attribute is read-only. -
updatedTime(optional):
[
"string",
"null"
]
The date and time when the file was last updated. This attribute is read-only.
-
uRL(optional):
string
Maximum Length:
1333
The URL to access the file.
Nested Schema : namedIDs-answers-guidedAssistance
Type:
object
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.
Show Source
-
id(optional):
integer
Minimum Value:
0
ID value -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object
Nested Schema : namedIDs-answers-language
Type:
object
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.
Show Source
-
id(optional):
integer
Minimum Value:
0
ID value -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object
Nested Schema : answers-notes
Type:
object
The note text associated with the objects such as contacts and organizations.
Show Source
-
channel(optional):
object namedIDs-answers-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(optional):
[
"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(optional):
string
The date and time when the note was created. This attribute is read-only.
-
id(optional):
integer
Minimum Value:
1
Maximum Value:9.223372036854776E18
The unique identifier of the note. -
text(optional):
string
Maximum Length:
349525
The text content in the note. -
updatedByAccount(optional):
[
"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(optional):
string
The date and time when the note was last updated. This attribute is read-only.
Nested Schema : namedIDs-answers-positionInList
Type:
object
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.
Show Source
-
id(optional):
integer
Minimum Value:
0
ID value -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object
Nested Schema : products
Type:
array
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.
Show Source
Nested Schema : siblingAnswers
Type:
array
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 resources.
Show Source
Nested Schema : answers-statusWithType
Type:
object
The status of an object with its associated status type.
Show Source
-
status(optional):
object namedIDs-answers-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(optional):
object namedIDs-answers-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 : answers-versionDetail
Type:
object
The details of the answer version.
Show Source
-
draftNote(optional):
[
"string",
"null"
]
Maximum Length:
1333
The draft note for the answer version. -
draftTime(optional):
string
The date and time when the draft answer version was created.
-
publishedTime(optional):
[
"string",
"null"
]
The date and time when the draft answer version was published.
-
publishNote(optional):
[
"string",
"null"
]
Maximum Length:
1333
The published note for the answer version. -
state(optional):
object namedIDs-answers-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(optional):
[
"string",
"null"
]
The date and time when the answer version was unpublished.
Nested Schema : namedIDs-answers-assignedTo-staffGroup
Type:
object
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.
Show Source
-
id(optional):
integer
Minimum Value:
0
ID value -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object
Nested Schema : items
Type:
object
Nested Schema : answers-commonAttachments-names
Type:
object
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.
Show Source
-
labelText(optional):
string
Maximum Length:
80
The language-specific label text. The value cannot be null or empty. -
language(optional):
object namedIDs-answers-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-answers-commonAttachments-names-language
Type:
object
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.
Show Source
-
id(optional):
integer
Minimum Value:
0
ID value -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object
Nested Schema : namedIDs-answers-notes-channel
Type:
object
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.
Show Source
-
id(optional):
integer
Minimum Value:
0
ID value -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object
Nested Schema : items
Type:
object
Nested Schema : items
Type:
object
Nested Schema : namedIDs-answers-statusWithType-status
Type:
object
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.
Show Source
-
id(optional):
integer
Minimum Value:
0
ID value -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object
Nested Schema : namedIDs-answers-statusWithType-statusType
Type:
object
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.
Show Source
-
id(optional):
integer
Minimum Value:
0
ID value -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object
Nested Schema : namedIDs-answers-versionDetail-state
Type:
object
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.
Show Source
-
id(optional):
integer
Minimum Value:
0
ID value -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object
Response
Default Response
Root Schema : answers
Type:
object
The knowledge base information that provides solutions to the common customer support questions.
Show Source
-
accessLevels(optional):
object namedIDs-answers-accessLevels
The named ID that can be included in a list.
-
adminLastAccessTime(optional):
[
"string",
"null"
]
The date and time when the answer was last accessed by an administrator. This attribute is read-only.
-
answerType(optional):
object namedIDs-answerTypes
The type of an answer.
-
answerVersion(optional):
object answerVersion
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. It is the reference to a resource in 'answerVersions' collection. Only ID or lookupName can be provided to specify the resource.
-
assignedSibling(optional):
[
"object",
"null"
]
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.
-
assignedTo(optional):
object answers-assignedTo
The collection of staff account and staff group.
-
banner(optional):
object answers-banner
The display flags of a banner.
-
categories(optional):
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(optional):
object answers-commonAttachments
The file attachment shared by sibling answers.
-
createdTime(optional):
string
The date and time when the answer was created. This attribute is read-only.
-
expiresDate(optional):
[
"string",
"null"
]
The date when the answer expires and is set to review status.
-
fileAttachments(optional):
object answers-fileAttachments
The file attachment shared by answers.
-
guidedAssistance(optional):
object namedIDs-answers-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(optional):
integer
Minimum Value:
1
Maximum Value:9.223372036854776E18
The unique identifier of the answer. -
keywords(optional):
[
"string",
"null"
]
Maximum Length:
1333
The list of space separated keywords associated with an answer. -
language(optional):
object namedIDs-answers-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(optional):
[
"string",
"null"
]
The date and time when the answer was last accessed. This attribute is read-only.
-
lastNotificationTime(optional):
[
"string",
"null"
]
The date and time when the last notification was generated. This attribute is read-only.
-
lookupName(optional):
string
Maximum Length:
255
The name used to look up the answer. -
name(optional):
string
Maximum Length:
20
The string version of the answer ID, which is used as the reference number of the answer. This attribute is read-only. -
nextNotificationTime(optional):
[
"string",
"null"
]
The date and time when the next earliest notification will be sent.
-
notes(optional):
object answers-notes
The note text associated with the objects such as contacts and organizations.
-
originalReferenceNumber(optional):
[
"string",
"null"
]
Maximum Length:
13
Pattern:^[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(optional):
object namedIDs-answers-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(optional):
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(optional):
[
"string",
"null"
]
The date when the answer will be published and made available to users.
-
question(optional):
[
"string",
"null"
]
Maximum Length:
1048576
The question or the description of the answer. - relatedAnswers(optional): object answers-relatedAnswers
-
siblingAnswers(optional):
array siblingAnswers
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 resources.
-
solution(optional):
[
"string",
"null"
]
Maximum Length:
1048576
The solution or the answer portion of the answer. -
specialResponse(optional):
[
"string",
"null"
]
Maximum Length:
1048576
The special response of the answer. -
statusWithType(optional):
object answers-statusWithType
The status of an object with its associated status type.
-
summary(optional):
string
Maximum Length:
240
The title or short summary of the answer. -
updatedByAccount(optional):
[
"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(optional):
string
The date and time when the answer was last updated. This attribute is read-only.
-
uRL(optional):
[
"string",
"null"
]
Maximum Length:
1333
The URL which returns the answer, if the answer type is URL. -
versionDetail(optional):
object answers-versionDetail
The details of the answer version.
Nested Schema : namedIDs-answers-accessLevels
Type:
object
The named ID that can be included in a list.
Show Source
-
id(optional):
integer
Minimum Value:
1
Maximum Value:9.223372036854776E18
The unique identifier of the access level. -
lookupName(optional):
string
Maximum Length:
255
The name used to look up the access level.
Nested Schema : namedIDs-answerTypes
Type:
object
The type of an answer.
Show Source
-
id(optional):
integer
Minimum Value:
1
Maximum Value:9.223372036854776E18
The unique identifier of the answer type. -
lookupName(optional):
string
Maximum Length:
255
The name used to look up the answer type.
Nested Schema : answerVersion
Type:
object
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. It is the reference to a resource in 'answerVersions' collection. Only ID or lookupName can be provided to specify the resource.
Nested Schema : answers-assignedTo
Type:
object
The collection of staff account and staff group.
Show Source
-
account(optional):
[
"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(optional):
object namedIDs-answers-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:
array
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.
Show Source
Nested Schema : answers-commonAttachments
Type:
object
The file attachment shared by sibling answers.
Show Source
-
contentType(optional):
string
Maximum Length:
128
Pattern:^[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(optional):
string
The date and time when the file was associated with the answer. This attribute is read-only.
-
data(optional):
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(optional):
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(optional):
string
Maximum Length:
100
Pattern:^[^ \/:*?"<>|]*$
The name of the file when saving it to the disk. -
formData(optional):
string
-
id(optional):
integer
Minimum Value:
1
Maximum Value:9.223372036854776E18
The unique identifier of the file attachment. -
names(optional):
object answers-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(optional):
boolean
Indicates whether the file attachment is hidden from the end users. This attribute does not have a default value.
-
size(optional):
integer
Minimum Value:
1
Maximum Value:2147483647
The size of the file in bytes. This attribute is read-only. -
updatedTime(optional):
[
"string",
"null"
]
The date and time when the file was last updated. This attribute is read-only.
-
uRL(optional):
string
Maximum Length:
1333
The URL to access this file.
Nested Schema : answers-fileAttachments
Type:
object
The file attachment shared by answers.
Show Source
-
contentType(optional):
string
Maximum Length:
128
Pattern:^[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(optional):
string
The date and time when the file was associated with the answer. This attribute is read-only.
-
data(optional):
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(optional):
string
Maximum Length:
1333
The description for the contents of the file attachment. -
disabled(optional):
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(optional):
string
Maximum Length:
100
Pattern:^[^ \/:*?"<>|]*$
The name of the file when saving it to the disk. -
formData(optional):
string
The HTML form which is used to upload file attachments.
-
id(optional):
integer
Minimum Value:
1
Maximum Value:9.223372036854776E18
The unique identifier of the file attachment. -
indexed(optional):
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(optional):
string
Maximum Length:
40
Pattern:^[^ ]*$
The short display name of the file attachment. -
private(optional):
boolean
Indicates whether the file attachment is hidden from the end users. The default value is false.
-
size(optional):
integer
Minimum Value:
1
Maximum Value:2147483647
The size of the file in bytes. This attribute is read-only. -
updatedTime(optional):
[
"string",
"null"
]
The date and time when the file was last updated. This attribute is read-only.
-
uRL(optional):
string
Maximum Length:
1333
The URL to access the file.
Nested Schema : namedIDs-answers-guidedAssistance
Type:
object
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.
Show Source
-
id(optional):
integer
Minimum Value:
0
ID value -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object
Nested Schema : namedIDs-answers-language
Type:
object
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.
Show Source
-
id(optional):
integer
Minimum Value:
0
ID value -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object
Nested Schema : answers-notes
Type:
object
The note text associated with the objects such as contacts and organizations.
Show Source
-
channel(optional):
object namedIDs-answers-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(optional):
[
"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(optional):
string
The date and time when the note was created. This attribute is read-only.
-
id(optional):
integer
Minimum Value:
1
Maximum Value:9.223372036854776E18
The unique identifier of the note. -
text(optional):
string
Maximum Length:
349525
The text content in the note. -
updatedByAccount(optional):
[
"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(optional):
string
The date and time when the note was last updated. This attribute is read-only.
Nested Schema : namedIDs-answers-positionInList
Type:
object
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.
Show Source
-
id(optional):
integer
Minimum Value:
0
ID value -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object
Nested Schema : products
Type:
array
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.
Show Source
Nested Schema : siblingAnswers
Type:
array
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 resources.
Show Source
Nested Schema : answers-statusWithType
Type:
object
The status of an object with its associated status type.
Show Source
-
status(optional):
object namedIDs-answers-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(optional):
object namedIDs-answers-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 : answers-versionDetail
Type:
object
The details of the answer version.
Show Source
-
draftNote(optional):
[
"string",
"null"
]
Maximum Length:
1333
The draft note for the answer version. -
draftTime(optional):
string
The date and time when the draft answer version was created.
-
publishedTime(optional):
[
"string",
"null"
]
The date and time when the draft answer version was published.
-
publishNote(optional):
[
"string",
"null"
]
Maximum Length:
1333
The published note for the answer version. -
state(optional):
object namedIDs-answers-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(optional):
[
"string",
"null"
]
The date and time when the answer version was unpublished.
Nested Schema : namedIDs-answers-assignedTo-staffGroup
Type:
object
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.
Show Source
-
id(optional):
integer
Minimum Value:
0
ID value -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object
Nested Schema : items
Type:
object
Nested Schema : answers-commonAttachments-names
Type:
object
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.
Show Source
-
labelText(optional):
string
Maximum Length:
80
The language-specific label text. The value cannot be null or empty. -
language(optional):
object namedIDs-answers-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-answers-commonAttachments-names-language
Type:
object
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.
Show Source
-
id(optional):
integer
Minimum Value:
0
ID value -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object
Nested Schema : namedIDs-answers-notes-channel
Type:
object
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.
Show Source
-
id(optional):
integer
Minimum Value:
0
ID value -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object
Nested Schema : items
Type:
object
Nested Schema : items
Type:
object
Nested Schema : namedIDs-answers-statusWithType-status
Type:
object
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.
Show Source
-
id(optional):
integer
Minimum Value:
0
ID value -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object
Nested Schema : namedIDs-answers-statusWithType-statusType
Type:
object
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.
Show Source
-
id(optional):
integer
Minimum Value:
0
ID value -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object
Nested Schema : namedIDs-answers-versionDetail-state
Type:
object
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.
Show Source
-
id(optional):
integer
Minimum Value:
0
ID value -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object
Examples
Use POST with the following syntax to create a new answer object:
https://your_site_interface/services/rest/connect/version/answers
Request URI example
https://mysite.example.com/services/rest/connect/v1.4/answers
Request body example
{
"answerType": {
"id": 1
},
"language": {
"id": 1
},
"solution": "The FishPhone is water resistant to 10 meters, or 33 feet.",
"summary": "How deep can I get my FishPhone?"
}
Note:
TheanswerType
,
language
, and
summary
fields are required for answers.
Response body example
{
"id": 57,
"lookupName": "57",
"createdTime": "2016-01-29T19:35:41.000Z",
"updatedTime": "2016-01-29T19:35:41.000Z",
"accessLevels": {
"links": [
{
"rel": "self",
"href": "https://mysite.example.com/services/rest/connect/v1.4/answers/57/accessLevels"
}
]
},
"adminLastAccessTime": "2016-01-29T19:35:41.000Z",
"answerType": {
"id": 1,
"lookupName": "HTML"
},
"assignedTo": {
"account": null,
"staffGroup": null
},
"banner": {
"importanceFlag": null,
"text": null,
"updatedByAccount": null,
"updatedTime": null
},
"categories": {
"links": [
{
"rel": "self",
"href": "https://mysite.example.com/services/rest/connect/v1.4/answers/57/categories"
}
]
},
"commonAttachments": {
"links": [
{
"rel": "self",
"href": "https://mysite.example.com/services/rest/connect/v1.4/answers/57/commonAttachments"
}
]
},
"customFields": {
"c": {}
},
"expiresDate": null,
"fileAttachments": {
"links": [
{
"rel": "self",
"href": "https://mysite.example.com/services/rest/connect/v1.4/answers/57/fileAttachments"
}
]
},
"guidedAssistance": null,
"keywords": null,
"language": {
"id": 1,
"lookupName": "en_US"
},
"lastAccessTime": "2016-01-29T19:35:41.000Z",
"lastNotificationTime": null,
"name": "57",
"nextNotificationTime": null,
"notes": {
"links": [
{
"rel": "self",
"href": "https://mysite.example.com/services/rest/connect/v1.4/answers/57/notes"
}
]
},
"originalReferenceNumber": null,
"positionInList": {
"id": 1,
"lookupName": "Historical Usefulness"
},
"products": {
"links": [
{
"rel": "self",
"href": "https://mysite.example.com/services/rest/connect/v1.4/answers/57/products"
}
]
},
"publishOnDate": null,
"question": null,
"relatedAnswers": {
"links": [
{
"rel": "self",
"href": "https://mysite.example.com/services/rest/connect/v1.4/answers/57/relatedAnswers"
}
]
},
"siblingAnswers": {
"links": [
{
"rel": "self",
"href": "https://mysite.example.com/services/rest/connect/v1.4/answers/57/siblingAnswers"
}
]
},
"solution": "The FishPhone is water resistant to 10 meters, or 33 feet.",
"statusWithType": {
"status": {
"id": 5,
"lookupName": "Private"
},
"statusType": {
"id": 5,
"lookupName": "Private"
}
},
"summary": "How deep can I get my FishPhone?",
"updatedByAccount": {
"links": [
{
"rel": "self",
"href": "https://mysite.example.com/services/rest/connect/v1.4/accounts/7"
},
{
"rel": "canonical",
"href": "https://mysite.example.com/services/rest/connect/v1.4/accounts/7"
},
{
"rel": "describedby",
"href": "https://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/accounts",
"mediaType": "application/schema+json"
}
]
},
"uRL": null,
"links": [
{
"rel": "self",
"href": "https://mysite.example.com/services/rest/connect/v1.4/answers/57"
},
{
"rel": "canonical",
"href": "https://mysite.example.com/services/rest/connect/v1.4/answers/57"
},
{
"rel": "describedby",
"href": "https://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/answers",
"mediaType": "application/schema+json"
}
]
}