Get an answer version
get
/services/rest/connect/v1.4/answerVersions/{id}
Request
Path Parameters
-
id: integer
The unique identifier of the answer version.
Response
Default Response
Root Schema : answerVersions
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.
Show Source
-
accessLevels(optional):
object namedIDs-answerVersions-accessLevels
The named ID that can be included in a list.
-
adminLastAccessTime(optional):
[
"string",
"null"
]
The date and time when the answer version was last accessed by an administrator. This attribute is read-only.
-
answer(optional):
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(optional):
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(optional):
object answerVersions-assignedTo
The collection of staff account and staff group.
-
banner(optional):
object answerVersions-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 answerVersions-commonAttachments
The file attachment shared by sibling answers.
-
createdTime(optional):
string
The date and time when the answer version was created. This attribute is read-only.
-
expiresDate(optional):
[
"string",
"null"
]
The date when the answer version expires and is set to review status.
-
fileAttachments(optional):
object answerVersions-fileAttachments
The file attachment shared by answers.
-
guidedAssistance(optional):
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(optional):
integer
Minimum Value:
1
Maximum Value:9.223372036854776E18
The unique identifier of the answer version. -
keywords(optional):
[
"string",
"null"
]
Maximum Length:
1333
The list of space separated keywords associated with an answer version. -
language(optional):
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(optional):
[
"string",
"null"
]
The date and time when the answer version 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 version. -
name(optional):
string
Maximum Length:
20
The string version of the answer ID, which is used as the reference number of the answer version. This attribute is read-only. -
nextNotificationTime(optional):
[
"string",
"null"
]
The date and time when the next notification will be sent.
-
notes(optional):
object answerVersions-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-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(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 version will be published and made available to users.
-
question(optional):
[
"string",
"null"
]
Maximum Length:
1048576
The question or the description of the answer version. - relatedAnswers(optional): object answerVersions-relatedAnswers
-
solution(optional):
[
"string",
"null"
]
Maximum Length:
1048576
The solution or the answer portion of this version of the answer. -
specialResponse(optional):
[
"string",
"null"
]
Maximum Length:
1048576
The special response of this version of the answer. -
statusWithType(optional):
object answerVersions-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 version. -
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 version was last updated. This attribute is read-only.
-
uRL(optional):
[
"string",
"null"
]
Maximum Length:
1333
The URL which returns this version of the answer, if the answer type is URL. -
versionDetail(optional):
object answerVersions-versionDetail
The details of the answer version.
Nested Schema : namedIDs-answerVersions-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 : answer
Type:
object
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.
Nested Schema : namedIDs-answerVersions-answerType
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 : answerVersions-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-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:
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 : answerVersions-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 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(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 : answerVersions-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-answerVersions-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-answerVersions-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 : answerVersions-notes
Type:
object
The note text associated with the objects such as contacts and organizations.
Show Source
-
channel(optional):
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(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-answerVersions-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 : answerVersions-statusWithType
Type:
object
The status of an object with its associated status type.
Show Source
-
status(optional):
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(optional):
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:
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-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(optional):
[
"string",
"null"
]
The date and time when the answer version was unpublished.
Nested Schema : namedIDs-answerVersions-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 : answerVersions-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-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:
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-answerVersions-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 : namedIDs-answerVersions-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-answerVersions-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-answerVersions-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 GET with the following syntax to retrieve data for an answerVersion object:
https://your_site_interface/services/rest/connect/version/answerVersions/answer_version_id
Request URI example
https://mysite.example.com/services/rest/connect/v1.4/answerVersions/1
Response body example
{
"id": 1,
"lookupName": "1",
"createdTime": "2005-09-29T18:55:29.000Z",
"updatedTime": "2010-03-24T06:03:03.000Z",
"accessLevels": {
"links": [
{
"rel": "self",
"href": "http://mysite.example.com/services/rest/connect/v1.4/answerVersions/1/accessLevels"
},
{
"rel": "full",
"href": "http://mysite.example.com/services/rest/connect/v1.4/answerVersions/1/accessLevels/{accessLevel_id}",
"templated": true
}
]
},
"adminLastAccessTime": null,
"answer": {
"links": [
{
"rel": "self",
"href": "http://mysite.example.com/services/rest/connect/v1.4/answers/1"
},
{
"rel": "canonical",
"href": "http://mysite.example.com/services/rest/connect/v1.4/answers/1"
},
{
"rel": "describedby",
"href": "http://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/answers",
"mediaType": "application/schema+json"
}
]
},
"answerType": {
"id": 1,
"lookupName": "HTML"
},
"assignedTo": {
"account": {
"links": [
{
"rel": "self",
"href": "http://mysite.example.com/services/rest/connect/v1.4/accounts/4"
},
{
"rel": "canonical",
"href": "http://mysite.example.com/services/rest/connect/v1.4/accounts/4"
},
{
"rel": "describedby",
"href": "http://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/accounts",
"mediaType": "application/schema+json"
}
]
},
"staffGroup": {
"id": 100127,
"lookupName": "Sales"
}
},
"banner": {
"importanceFlag": null,
"text": null,
"updatedByAccount": null,
"updatedTime": null
},
"categories": {
"links": [
{
"rel": "self",
"href": "http://mysite.example.com/services/rest/connect/v1.4/answerVersions/1/categories"
},
{
"rel": "full",
"href": "http://mysite.example.com/services/rest/connect/v1.4/answerVersions/1/categories/{category_id}",
"templated": true
}
]
},
"commonAttachments": {
"links": [
{
"rel": "self",
"href": "http://mysite.example.com/services/rest/connect/v1.4/answerVersions/1/commonAttachments"
},
{
"rel": "full",
"href": "http://mysite.example.com/services/rest/connect/v1.4/answerVersions/1/commonAttachments/{commonAttachment_id}",
"templated": true
}
]
},
"customFields": {
"CO": {
"AnsBool": null,
"AnsInteger": null,
"AnsText": null,
"Country": null,
"ThingsToDo": null,
"defect_id": null,
"parent_a_id": null,
"sibling_a_id": null
},
"c": {
"bucket": null,
"date1": null,
"dttm1": null,
"int1": null,
"menu1": null,
"textarea1": null,
"yesno1": null,
"url": null,
"email": null,
"phone": null
}
},
"expiresDate": "2005-10-07",
"fileAttachments": {
"links": [
{
"rel": "self",
"href": "http://mysite.example.com/services/rest/connect/v1.4/answerVersions/1/fileAttachments"
},
{
"rel": "full",
"href": "http://mysite.example.com/services/rest/connect/v1.4/answerVersions/1/fileAttachments/{fileAttachment_id}",
"templated": true
}
]
},
"guidedAssistance": null,
"keywords": null,
"language": {
"id": 1,
"lookupName": "en_US"
},
"lastAccessTime": "2012-03-03T00:56:28.000Z",
"lastNotificationTime": null,
"name": "1",
"nextNotificationTime": null,
"notes": {
"links": [
{
"rel": "self",
"href": "http://mysite.example.com/services/rest/connect/v1.4/answerVersions/1/notes"
},
{
"rel": "full",
"href": "http://mysite.example.com/services/rest/connect/v1.4/answerVersions/1/notes/{note_id}",
"templated": true
}
]
},
"originalReferenceNumber": "050923-000020",
"positionInList": {
"id": 1,
"lookupName": "Historical Usefulness"
},
"products": {
"links": [
{
"rel": "self",
"href": "http://mysite.example.com/services/rest/connect/v1.4/answerVersions/1/products"
},
{
"rel": "full",
"href": "http://mysite.example.com/services/rest/connect/v1.4/answerVersions/1/products/{product_id}",
"templated": true
}
]
},
"publishOnDate": "2005-10-12",
"question": "Interface: global\n\n",
"relatedAnswers": {
"links": [
{
"rel": "self",
"href": "http://mysite.example.com/services/rest/connect/v1.4/answerVersions/1/relatedAnswers"
},
{
"rel": "full",
"href": "http://mysite.example.com/services/rest/connect/v1.4/answerVersions/1/relatedAnswers/{relatedAnswer_id}",
"templated": true
}
]
},
"solution": "To change your address, simply log onto the Global Wireless Customer area. Enter your wireless phone number and password to access your account. Click My Profile to change your personal information, including your address.",
"statusWithType": {
"status": {
"id": 4,
"lookupName": "Public"
},
"statusType": {
"id": 4,
"lookupName": "Public"
}
},
"summary": "How do I change my address?",
"updatedByAccount": {
"links": [
{
"rel": "self",
"href": "http://mysite.example.com/services/rest/connect/v1.4/accounts/2"
},
{
"rel": "canonical",
"href": "http://mysite.example.com/services/rest/connect/v1.4/accounts/2"
},
{
"rel": "describedby",
"href": "http://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/accounts",
"mediaType": "application/schema+json"
}
]
},
"uRL": null,
"versionDetail": {
"draftTime": "2005-09-29T18:55:29.000Z",
"draftNote": null,
"publishedTime": "2005-09-29T18:55:29.000Z",
"publishNote": null,
"state": {
"id": 2,
"lookupName": "Live"
},
"unpublishedTime": null
},
"links": [
{
"rel": "self",
"href": "http://mysite.example.com/services/rest/connect/v1.4/answerVersions/1"
},
{
"rel": "canonical",
"href": "http://mysite.example.com/services/rest/connect/v1.4/answerVersions/1"
},
{
"rel": "describedby",
"href": "http://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/answerVersions",
"mediaType": "application/schema+json"
}
]
}