Create an incident
post
/services/rest/connect/v1.4/incidents
Request
The question or the request for help submitted by a customer through the Ask a Question page, email, a chat session, site or answer feedback, or from an external source using the API. Incidents can also be added by agents when they work with customers by phone, fax, or mail.
Root Schema : incidents
Type:
object
The question or the request for help submitted by a customer through the Ask a Question page, email, a chat session, site or answer feedback, or from an external source using the API. Incidents can also be added by agents when they work with customers by phone, fax, or mail.
Show Source
-
asset(optional):
[
"object",
"null"
]
The product or service associated with an organization's customers. It is the reference to a resource in 'assets' collection. Only ID or lookupName can be provided to specify the resource.
-
assignedTo(optional):
object incidents-assignedTo
The collection of staff account and staff group.
-
banner(optional):
object incidents-banner
The display flags of a banner.
-
billedMinutes(optional):
object incidents-billedMinutes
The work time applied to incidents through the Time Billed feature.
-
category(optional):
[
"object",
"null"
]
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 resource.
-
channel(optional):
object namedIDs-incidents-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.
-
chatQueue(optional):
object namedIDs-incidents-chatQueue
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.
-
closedTime(optional):
[
"string",
"null"
]
The date and time when the incident was closed. This attribute is read-only.
-
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 incident was created.
-
disposition(optional):
[
"object",
"null"
]
The hierarchical service disposition that provides an option for classifying and recording how incidents are ultimately resolved. It is the reference to a resource in 'serviceDispositions' collection. Only ID or lookupName can be provided to specify the resource.
-
fileAttachments(optional):
object incidents-fileAttachments
The file attachment that includes fields specific to incidents.
-
id(optional):
integer
Minimum Value:
1
Maximum Value:9.223372036854776E18
The unique identifier of the incident. -
initialResponseDueTime(optional):
[
"string",
"null"
]
The due date that is required to conform to the SLA. If SLAs have not been implemented, this would apply to the default response requirements. This attribute is read-only.
-
initialSolutionTime(optional):
[
"string",
"null"
]
The date and time when a response was sent to the customer for a status change other than 'unresolved'. This attribute is read-only.
-
interface(optional):
object interface
The console, windows, and pages used by staff members and customers to access the application and interact with a single knowledge base. The interface name determines the URL for the web site, the name of the system executables, and the .cfg directory name. It is the reference to a resource in 'siteInterfaces' collection. Only ID or lookupName can be provided to specify the resource.
-
language(optional):
object namedIDs-incidents-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.
-
lastResponseTime(optional):
[
"string",
"null"
]
The date and time when the last response was sent to the contact. This attribute is read-only.
-
lastSurveyScore(optional):
[
"integer",
"null"
]
Minimum Value:
0
Maximum Value:32767
The score of the last survey of the incident. This attribute is read-only. -
lookupName(optional):
string
Maximum Length:
255
The name used to look up the incident. -
mailbox(optional):
[
"object",
"null"
]
The mailbox used for collecting email inquiries sent by customers, responses to mailings, and bounced messages. It is the reference to a resource in 'mailboxes' collection. Only ID or lookupName can be provided to specify the resource.
-
mailing(optional):
object namedIDs-incidents-mailing
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.
-
milestoneInstances(optional):
object incidents-milestoneInstances
The milestone instances associated with incidents.
-
organization(optional):
[
"object",
"null"
]
The company, business unit of a large company, or government agency that has an organization record in the Oracle B2C Service knowledge base. It is the reference to a resource in 'organizations' collection. Only ID or lookupName can be provided to specify the resource.
-
otherContacts(optional):
array otherContacts
The customers or end users of Oracle B2C Service site. A contact contains basic information such as a customer's name, email address, and phone number. It also contains information about customer service issues, opportunities, and marketing mailings subscription status. It is the reference to a resource in 'contacts' collection. Only ID or lookupName can be provided to specify the resources.
-
primaryContact(optional):
object primaryContact
The customers or end users of Oracle B2C Service site. A contact contains basic information such as a customer's name, email address, and phone number. It also contains information about customer service issues, opportunities, and marketing mailings subscription status. It is the reference to a resource in 'contacts' collection. Only ID or lookupName can be provided to specify the resource.
-
product(optional):
[
"object",
"null"
]
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 resource.
-
queue(optional):
object namedIDs-incidents-queue
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.
-
referenceNumber(optional):
string
Maximum Length:
13
Pattern:^[0-9]{2}[0|1][0-9][0-3][0-9]\-[0-9]{6}$
The reference number generated when the incident was created. It is also referred as the incident name. -
resolutionInterval(optional):
[
"integer",
"null"
]
The number of minutes taken to resolve the incident past the SLA's resolution requirement. This attribute is read-only.
-
responseEmailAddressType(optional):
object namedIDs-incidents-responseEmailAddressType
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.
-
responseInterval(optional):
[
"integer",
"null"
]
The number of minutes taken to respond to the incident past the SLA's response requirement. This attribute is read-only.
-
severity(optional):
object namedIDs-incidents-severity
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.
-
sLAInstance(optional):
object incidents-sLAInstance
The instance of a Service Level Agreement (SLA) as applied to an incident.
-
smartSenseCustomer(optional):
[
"integer",
"null"
]
Minimum Value:
-3
Maximum Value:3
The emotive index calculated from the contact-generated threads. This attribute is read-only. -
smartSenseStaff(optional):
[
"integer",
"null"
]
Minimum Value:
-3
Maximum Value:3
The emotive index calculated from the staff-generated threads. This attribute is read-only. -
source(optional):
object namedIDHierarchies-incidents-source
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.
-
statusWithType(optional):
object incidents-statusWithType
The status of an object with its associated status type.
-
subject(optional):
[
"string",
"null"
]
Maximum Length:
240
The short description of the incident. -
threads(optional):
object incidents-threads
The incident discussion thread entry.
-
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 incident was last updated.
Nested Schema : incidents-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-incidents-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 : incidents-billedMinutes
Type:
object
The work time applied to incidents through the Time Billed feature.
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.
-
billableTask(optional):
object namedIDs-incidents-billedMinutes-billableTask
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.
-
billTime(optional):
string
The date and time when the work was performed. This is part of the key for the list entry.
-
comment(optional):
[
"string",
"null"
]
Maximum Length:
1333
The comments associated with the timeBilled record. -
id(optional):
integer
Minimum Value:
1
Maximum Value:9.223372036854776E18
The unique identifier of the timeBilled record. -
minutes(optional):
integer
Minimum Value:
1
Maximum Value:1440
The number of minutes billed.
Nested Schema : namedIDs-incidents-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 : namedIDs-incidents-chatQueue
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 : incidents-fileAttachments
Type:
object
The file attachment that includes fields specific to incidents.
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 incident. 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. -
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. -
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. 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 : interface
Type:
object
The console, windows, and pages used by staff members and customers to access the application and interact with a single knowledge base. The interface name determines the URL for the web site, the name of the system executables, and the .cfg directory name. It is the reference to a resource in 'siteInterfaces' collection. Only ID or lookupName can be provided to specify the resource.
Nested Schema : namedIDs-incidents-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-incidents-mailing
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 : incidents-milestoneInstances
Type:
object
The milestone instances associated with incidents.
Show Source
-
milestone(optional):
object namedIDs-incidents-milestoneInstances-milestone
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.
-
resolutionDueTime(optional):
string
The date and time when the associated resolution milestone is due.
Nested Schema : otherContacts
Type:
array
The customers or end users of Oracle B2C Service site. A contact contains basic information such as a customer's name, email address, and phone number. It also contains information about customer service issues, opportunities, and marketing mailings subscription status. It is the reference to a resource in 'contacts' collection. Only ID or lookupName can be provided to specify the resources.
Show Source
Nested Schema : primaryContact
Type:
object
The customers or end users of Oracle B2C Service site. A contact contains basic information such as a customer's name, email address, and phone number. It also contains information about customer service issues, opportunities, and marketing mailings subscription status. It is the reference to a resource in 'contacts' collection. Only ID or lookupName can be provided to specify the resource.
Nested Schema : namedIDs-incidents-queue
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-incidents-responseEmailAddressType
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-incidents-severity
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 : incidents-sLAInstance
Type:
object
The instance of a Service Level Agreement (SLA) as applied to an incident.
Show Source
-
activeDate(optional):
string
The date when the instance became active.
-
expireDate(optional):
string
The date when the instance is scheduled to expire. This attribute is read-only.
-
id(optional):
integer
Minimum Value:
1
Maximum Value:9.223372036854776E18
The unique identifier of the SLAInstance. -
nameOfSLA(optional):
object namedIDs-incidents-sLAInstance-nameOfSLA
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.
-
remainingFromChat(optional):
[
"integer",
"null"
]
Minimum Value:
0
Maximum Value:2147483647
The remaining number of chat incidents. This attribute is read-only. -
remainingFromCSR(optional):
[
"integer",
"null"
]
Minimum Value:
0
Maximum Value:2147483647
The remaining number of CSR incidents. This attribute is read-only. -
remainingFromEmail(optional):
[
"integer",
"null"
]
Minimum Value:
0
Maximum Value:2147483647
The remaining number of email incidents. This attribute is read-only. -
remainingFromWeb(optional):
[
"integer",
"null"
]
Minimum Value:
0
Maximum Value:2147483647
The remaining number of web self-service incidents. This attribute is read-only. -
remainingTotal(optional):
[
"integer",
"null"
]
Minimum Value:
0
Maximum Value:2147483647
The total number of remaining incidents. This attribute is read-only. -
sLASet(optional):
integer
Minimum Value:
1
Maximum Value:2147483647
The SLA set from which the instance was created. This attribute is read-only. -
stateOfSLA(optional):
object namedIDs-incidents-sLAInstance-stateOfSLA
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 : namedIDHierarchies-incidents-source
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:
1
ID value -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object -
parents(optional):
object namedIDHierarchies-incidents-source-parents
NamedID in which the ID is read-only. Used for hierarchies, where caller can specify the parents by name, but cannot specify the parent IDs.
Nested Schema : incidents-statusWithType
Type:
object
The status of an object with its associated status type.
Show Source
-
status(optional):
object namedIDs-incidents-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-incidents-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 : incidents-threads
Type:
object
The incident discussion thread entry.
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.
-
channel(optional):
object namedIDs-incidents-threads-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.
-
contact(optional):
[
"object",
"null"
]
The customers or end users of Oracle B2C Service site. A contact contains basic information such as a customer's name, email address, and phone number. It also contains information about customer service issues, opportunities, and marketing mailings subscription status. It is the reference to a resource in 'contacts' collection. Only ID or lookupName can be provided to specify the resource.
-
contentType(optional):
object namedIDs-incidents-threads-contentType
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.
-
createdTime(optional):
string
The date and time when the thread was created. This attribute is read-only.
-
displayOrder(optional):
integer
Minimum Value:
1
Maximum Value:2147483647
The relative display order for the threads with the same created time. This attribute is read-only. -
entryType(optional):
object namedIDs-incidents-threads-entryType
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 thread. It cannot be used for delete operations. -
mailHeader(optional):
[
"string",
"null"
]
Maximum Length:
349525
The mail header information for a contact submitting the thread by email. -
text(optional):
string
Maximum Length:
349525
The entry text in the thread.
Nested Schema : namedIDs-incidents-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 : namedIDs-incidents-billedMinutes-billableTask
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-incidents-milestoneInstances-milestone
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-incidents-sLAInstance-nameOfSLA
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-incidents-sLAInstance-stateOfSLA
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 : namedIDHierarchies-incidents-source-parents
Type:
object
NamedID in which the ID is read-only. Used for hierarchies, where caller can specify the parents by name, but cannot specify the parent IDs.
Show Source
-
id(optional):
integer
Minimum Value:
1
ID value. Read-only -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object
Nested Schema : namedIDs-incidents-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-incidents-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-incidents-threads-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 : namedIDs-incidents-threads-contentType
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-incidents-threads-entryType
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 : incidents
Type:
object
The question or the request for help submitted by a customer through the Ask a Question page, email, a chat session, site or answer feedback, or from an external source using the API. Incidents can also be added by agents when they work with customers by phone, fax, or mail.
Show Source
-
asset(optional):
[
"object",
"null"
]
The product or service associated with an organization's customers. It is the reference to a resource in 'assets' collection. Only ID or lookupName can be provided to specify the resource.
-
assignedTo(optional):
object incidents-assignedTo
The collection of staff account and staff group.
-
banner(optional):
object incidents-banner
The display flags of a banner.
-
billedMinutes(optional):
object incidents-billedMinutes
The work time applied to incidents through the Time Billed feature.
-
category(optional):
[
"object",
"null"
]
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 resource.
-
channel(optional):
object namedIDs-incidents-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.
-
chatQueue(optional):
object namedIDs-incidents-chatQueue
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.
-
closedTime(optional):
[
"string",
"null"
]
The date and time when the incident was closed. This attribute is read-only.
-
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 incident was created.
-
disposition(optional):
[
"object",
"null"
]
The hierarchical service disposition that provides an option for classifying and recording how incidents are ultimately resolved. It is the reference to a resource in 'serviceDispositions' collection. Only ID or lookupName can be provided to specify the resource.
-
fileAttachments(optional):
object incidents-fileAttachments
The file attachment that includes fields specific to incidents.
-
id(optional):
integer
Minimum Value:
1
Maximum Value:9.223372036854776E18
The unique identifier of the incident. -
initialResponseDueTime(optional):
[
"string",
"null"
]
The due date that is required to conform to the SLA. If SLAs have not been implemented, this would apply to the default response requirements. This attribute is read-only.
-
initialSolutionTime(optional):
[
"string",
"null"
]
The date and time when a response was sent to the customer for a status change other than 'unresolved'. This attribute is read-only.
-
interface(optional):
object interface
The console, windows, and pages used by staff members and customers to access the application and interact with a single knowledge base. The interface name determines the URL for the web site, the name of the system executables, and the .cfg directory name. It is the reference to a resource in 'siteInterfaces' collection. Only ID or lookupName can be provided to specify the resource.
-
language(optional):
object namedIDs-incidents-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.
-
lastResponseTime(optional):
[
"string",
"null"
]
The date and time when the last response was sent to the contact. This attribute is read-only.
-
lastSurveyScore(optional):
[
"integer",
"null"
]
Minimum Value:
0
Maximum Value:32767
The score of the last survey of the incident. This attribute is read-only. -
lookupName(optional):
string
Maximum Length:
255
The name used to look up the incident. -
mailbox(optional):
[
"object",
"null"
]
The mailbox used for collecting email inquiries sent by customers, responses to mailings, and bounced messages. It is the reference to a resource in 'mailboxes' collection. Only ID or lookupName can be provided to specify the resource.
-
mailing(optional):
object namedIDs-incidents-mailing
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.
-
milestoneInstances(optional):
object incidents-milestoneInstances
The milestone instances associated with incidents.
-
organization(optional):
[
"object",
"null"
]
The company, business unit of a large company, or government agency that has an organization record in the Oracle B2C Service knowledge base. It is the reference to a resource in 'organizations' collection. Only ID or lookupName can be provided to specify the resource.
-
otherContacts(optional):
array otherContacts
The customers or end users of Oracle B2C Service site. A contact contains basic information such as a customer's name, email address, and phone number. It also contains information about customer service issues, opportunities, and marketing mailings subscription status. It is the reference to a resource in 'contacts' collection. Only ID or lookupName can be provided to specify the resources.
-
primaryContact(optional):
object primaryContact
The customers or end users of Oracle B2C Service site. A contact contains basic information such as a customer's name, email address, and phone number. It also contains information about customer service issues, opportunities, and marketing mailings subscription status. It is the reference to a resource in 'contacts' collection. Only ID or lookupName can be provided to specify the resource.
-
product(optional):
[
"object",
"null"
]
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 resource.
-
queue(optional):
object namedIDs-incidents-queue
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.
-
referenceNumber(optional):
string
Maximum Length:
13
Pattern:^[0-9]{2}[0|1][0-9][0-3][0-9]\-[0-9]{6}$
The reference number generated when the incident was created. It is also referred as the incident name. -
resolutionInterval(optional):
[
"integer",
"null"
]
The number of minutes taken to resolve the incident past the SLA's resolution requirement. This attribute is read-only.
-
responseEmailAddressType(optional):
object namedIDs-incidents-responseEmailAddressType
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.
-
responseInterval(optional):
[
"integer",
"null"
]
The number of minutes taken to respond to the incident past the SLA's response requirement. This attribute is read-only.
-
severity(optional):
object namedIDs-incidents-severity
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.
-
sLAInstance(optional):
object incidents-sLAInstance
The instance of a Service Level Agreement (SLA) as applied to an incident.
-
smartSenseCustomer(optional):
[
"integer",
"null"
]
Minimum Value:
-3
Maximum Value:3
The emotive index calculated from the contact-generated threads. This attribute is read-only. -
smartSenseStaff(optional):
[
"integer",
"null"
]
Minimum Value:
-3
Maximum Value:3
The emotive index calculated from the staff-generated threads. This attribute is read-only. -
source(optional):
object namedIDHierarchies-incidents-source
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.
-
statusWithType(optional):
object incidents-statusWithType
The status of an object with its associated status type.
-
subject(optional):
[
"string",
"null"
]
Maximum Length:
240
The short description of the incident. -
threads(optional):
object incidents-threads
The incident discussion thread entry.
-
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 incident was last updated.
Nested Schema : incidents-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-incidents-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 : incidents-billedMinutes
Type:
object
The work time applied to incidents through the Time Billed feature.
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.
-
billableTask(optional):
object namedIDs-incidents-billedMinutes-billableTask
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.
-
billTime(optional):
string
The date and time when the work was performed. This is part of the key for the list entry.
-
comment(optional):
[
"string",
"null"
]
Maximum Length:
1333
The comments associated with the timeBilled record. -
id(optional):
integer
Minimum Value:
1
Maximum Value:9.223372036854776E18
The unique identifier of the timeBilled record. -
minutes(optional):
integer
Minimum Value:
1
Maximum Value:1440
The number of minutes billed.
Nested Schema : namedIDs-incidents-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 : namedIDs-incidents-chatQueue
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 : incidents-fileAttachments
Type:
object
The file attachment that includes fields specific to incidents.
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 incident. 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. -
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. -
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. 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 : interface
Type:
object
The console, windows, and pages used by staff members and customers to access the application and interact with a single knowledge base. The interface name determines the URL for the web site, the name of the system executables, and the .cfg directory name. It is the reference to a resource in 'siteInterfaces' collection. Only ID or lookupName can be provided to specify the resource.
Nested Schema : namedIDs-incidents-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-incidents-mailing
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 : incidents-milestoneInstances
Type:
object
The milestone instances associated with incidents.
Show Source
-
milestone(optional):
object namedIDs-incidents-milestoneInstances-milestone
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.
-
resolutionDueTime(optional):
string
The date and time when the associated resolution milestone is due.
Nested Schema : otherContacts
Type:
array
The customers or end users of Oracle B2C Service site. A contact contains basic information such as a customer's name, email address, and phone number. It also contains information about customer service issues, opportunities, and marketing mailings subscription status. It is the reference to a resource in 'contacts' collection. Only ID or lookupName can be provided to specify the resources.
Show Source
Nested Schema : primaryContact
Type:
object
The customers or end users of Oracle B2C Service site. A contact contains basic information such as a customer's name, email address, and phone number. It also contains information about customer service issues, opportunities, and marketing mailings subscription status. It is the reference to a resource in 'contacts' collection. Only ID or lookupName can be provided to specify the resource.
Nested Schema : namedIDs-incidents-queue
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-incidents-responseEmailAddressType
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-incidents-severity
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 : incidents-sLAInstance
Type:
object
The instance of a Service Level Agreement (SLA) as applied to an incident.
Show Source
-
activeDate(optional):
string
The date when the instance became active.
-
expireDate(optional):
string
The date when the instance is scheduled to expire. This attribute is read-only.
-
id(optional):
integer
Minimum Value:
1
Maximum Value:9.223372036854776E18
The unique identifier of the SLAInstance. -
nameOfSLA(optional):
object namedIDs-incidents-sLAInstance-nameOfSLA
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.
-
remainingFromChat(optional):
[
"integer",
"null"
]
Minimum Value:
0
Maximum Value:2147483647
The remaining number of chat incidents. This attribute is read-only. -
remainingFromCSR(optional):
[
"integer",
"null"
]
Minimum Value:
0
Maximum Value:2147483647
The remaining number of CSR incidents. This attribute is read-only. -
remainingFromEmail(optional):
[
"integer",
"null"
]
Minimum Value:
0
Maximum Value:2147483647
The remaining number of email incidents. This attribute is read-only. -
remainingFromWeb(optional):
[
"integer",
"null"
]
Minimum Value:
0
Maximum Value:2147483647
The remaining number of web self-service incidents. This attribute is read-only. -
remainingTotal(optional):
[
"integer",
"null"
]
Minimum Value:
0
Maximum Value:2147483647
The total number of remaining incidents. This attribute is read-only. -
sLASet(optional):
integer
Minimum Value:
1
Maximum Value:2147483647
The SLA set from which the instance was created. This attribute is read-only. -
stateOfSLA(optional):
object namedIDs-incidents-sLAInstance-stateOfSLA
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 : namedIDHierarchies-incidents-source
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:
1
ID value -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object -
parents(optional):
object namedIDHierarchies-incidents-source-parents
NamedID in which the ID is read-only. Used for hierarchies, where caller can specify the parents by name, but cannot specify the parent IDs.
Nested Schema : incidents-statusWithType
Type:
object
The status of an object with its associated status type.
Show Source
-
status(optional):
object namedIDs-incidents-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-incidents-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 : incidents-threads
Type:
object
The incident discussion thread entry.
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.
-
channel(optional):
object namedIDs-incidents-threads-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.
-
contact(optional):
[
"object",
"null"
]
The customers or end users of Oracle B2C Service site. A contact contains basic information such as a customer's name, email address, and phone number. It also contains information about customer service issues, opportunities, and marketing mailings subscription status. It is the reference to a resource in 'contacts' collection. Only ID or lookupName can be provided to specify the resource.
-
contentType(optional):
object namedIDs-incidents-threads-contentType
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.
-
createdTime(optional):
string
The date and time when the thread was created. This attribute is read-only.
-
displayOrder(optional):
integer
Minimum Value:
1
Maximum Value:2147483647
The relative display order for the threads with the same created time. This attribute is read-only. -
entryType(optional):
object namedIDs-incidents-threads-entryType
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 thread. It cannot be used for delete operations. -
mailHeader(optional):
[
"string",
"null"
]
Maximum Length:
349525
The mail header information for a contact submitting the thread by email. -
text(optional):
string
Maximum Length:
349525
The entry text in the thread.
Nested Schema : namedIDs-incidents-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 : namedIDs-incidents-billedMinutes-billableTask
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-incidents-milestoneInstances-milestone
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-incidents-sLAInstance-nameOfSLA
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-incidents-sLAInstance-stateOfSLA
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 : namedIDHierarchies-incidents-source-parents
Type:
object
NamedID in which the ID is read-only. Used for hierarchies, where caller can specify the parents by name, but cannot specify the parent IDs.
Show Source
-
id(optional):
integer
Minimum Value:
1
ID value. Read-only -
lookupName(optional):
string
Maximum Length:
255
Name used to lookup this object
Nested Schema : namedIDs-incidents-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-incidents-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-incidents-threads-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 : namedIDs-incidents-threads-contentType
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-incidents-threads-entryType
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 incident object:
https://your_site_interface/services/rest/connect/version/incidents
Request URI example
https://mysite.example.com/services/rest/connect/v1.4/incidents
Request body example
{
"primaryContact":
{
"id": 2
},
"subject": "FishPhone not working"
}
Note:
TheprimaryContact
(ID or LookupName) and
subject
fields are required for incidents.
Response body example
{
"id": 67,
"lookupName": "160128-000000",
"createdTime": "2016-01-28T21:06:35.000Z",
"updatedTime": "2016-01-28T21:06:35.000Z",
"asset": null,
"assignedTo": {
"account": null,
"staffGroup": null
},
...
"primaryContact": {
"links": [
{
"rel": "self",
"href": "https://mysite.example.com/services/rest/connect/v1.4/contacts/2"
},
{
"rel": "canonical",
"href": "https://mysite.example.com/services/rest/connect/v1.4/contacts/2"
},
{
"rel": "describedby",
"href": "https://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/contacts"
}
]
},
...
"subject": "FishPhone not working",
"threads": {
"links": [
{
"rel": "self",
"href": "https://mysite.example.com/services/rest/connect/v1.4/incidents/32/threads"
}
]
},
"links": [
{
"rel": "self",
"href": "https://mysite.example.com/services/rest/connect/v1.4/incidents/32"
},
{
"rel": "canonical",
"href": "https://mysite.example.com/services/rest/connect/v1.4/incidents/32"
},
{
"rel": "describedby",
"href": "https://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/incidents"
},
{
"rel": "alternate",
"href": "https://mysite.example.com/services/rest/connect/v1.4/incidents/32",
"mediaType": "application/schema+json"
}
]
}