Update a message

patch

/crmRestApi/resources/11.13.18.05/internalServiceRequests/{SrId}/child/messages/{MessageId}

Request

Path Parameters
  • The value of this parameter could be a hash of the key that is used to uniquely identify the resource item. The client should not generate the hash key value. Instead, the client should query on the collection resource with a filter to navigate to a specific resource item. For example: products?q=InventoryItemId=
  • The value of this parameter could be a hash of the key that is used to uniquely identify the resource item. The client should not generate the hash key value. Instead, the client should query on the collection resource with a filter to navigate to a specific resource item. For example: products?q=InventoryItemId=
Header Parameters
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • Attachments
    Title: Attachments
    The attachments resource is used to view, create, and update attachments.
  • Service Request Communications
    Title: Service Request Communications
    The channel communications resource is used to view, create, update, and delete a communication. It contains information about the communication between support agents and workers. For example, the type of information recorded about communications include message identifiers, contact identifiers, and contact point identifiers.
  • Title: Channel
    The unique identifier of the channel.
  • Title: Channel Type
    Maximum Length: 30
    The channel type, such a email, phone, social, and so on.
  • Title: Collaboration Resource
    The unique identifier of the collaboration network user that the internal users are communicating with.
  • Title: Message Content
    The content of the service request message.
  • Title: Created By
    Maximum Length: 64
    The user who created the message in the original source system. This is applicable if the service request message was imported from another system.
  • Title: Message Expand State
    The message expanding state.
  • Title: Message ID
    The unique identifier of the service request message.
  • Title: Last Updated Date
    The date when the message was last updated in the original source system. This is applicable if the service request message was imported from another system.
  • Title: Last Updated By
    Maximum Length: 64
    The user who last updated the message in the original source system. This is applicable if the service request message was imported from another system.
  • Title: Last Update Login
    Maximum Length: 32
    The login of the user who last updated the message in the original source system. This is applicable if the service request message was imported from another system.
  • Title: Message Subtype
    Maximum Length: 30
    The service request message subtype.
  • Title: Message Type Code
    Maximum Length: 30
    The message type. The accepted values are Response, Customer Entry, System Note, System Response, and Internal Note.
  • Title: Notification Processing Status Code
    Maximum Length: 30
    The notification processing status code.
  • Title: Notification Retry Count
    The notification retry count.
  • Title: Object ID
    The unique identifier of the object.
  • Title: Original System
    Maximum Length: 255
    The unique identifier of the message record in the original source system from where the message was imported. This is applicable if the service request message was imported from another system.
  • Title: Origination Date
    The date the message was created in the original source system. This is applicable if the service request message was imported from another system.
  • Title: Parent Message ID
    The unique identifier of the parent message.
  • Title: Posted by ID
    The unique identifier of the user who the posted the message. The user can be an internal resource or a customer contact.
  • Title: Contains PII Data
    Maximum Length: 1
    Indicates whether the message contains personally identifiable information.
  • Title: Processing Status
    Maximum Length: 30
    Default Value: ORA_SVC_READY
    The processing status of the message. The accepted values are Ready, Processing, Error, and Success.
  • Title: Rich Text
    Maximum Length: 1
    Default Value: true
    Indicates whether the message content is in rich text format. If the format is rich text, then the value is Y, else the value is N.
  • Title: Sent Date
    The date and time when the message was sent.
  • Title: Private Message
    Maximum Length: 1
    Indicates whether the service request was created from a private social post.
  • Title: Source Code
    Maximum Length: 30
    The source of the message.
  • Title: Service Request ID
    The unique identifier of the service request to which the message is associated.
  • Title: Inline Attachment Identifiers
    Maximum Length: 1000
    The list of inline attachment identifiers associated with the service request
  • Title: Status Code
    Maximum Length: 30
    The status of the message. The accepted values are Draft, Committed, and Corrected.
  • Title: Subject
    Maximum Length: 1000
    The subject of the service request message.
  • Title: Template Name
    Maximum Length: 240
    The name of the template that's used for outbound communication of the message.
  • Title: Visibility Code
    Maximum Length: 30
    The privacy level of the message. The accepted values are Internal and External. Null value indicates that the message is External.
Nested Schema : Attachments
Type: array
Title: Attachments
The attachments resource is used to view, create, and update attachments.
Show Source
Nested Schema : Service Request Communications
Type: array
Title: Service Request Communications
The channel communications resource is used to view, create, update, and delete a communication. It contains information about the communication between support agents and workers. For example, the type of information recorded about communications include message identifiers, contact identifiers, and contact point identifiers.
Show Source
Nested Schema : internalServiceRequests-messages-Attachment-item-patch-request
Type: object
Show Source
Nested Schema : AttachmentsDFFVL
Type: array
Show Source
Nested Schema : Attachments Preview
Type: array
Title: Attachments Preview
The attachments preview resource is used to preview the attachment pages.
Show Source
Nested Schema : internalServiceRequests-messages-Attachment-AttachmentsDFFVL-item-patch-request
Type: object
Show Source
Nested Schema : internalServiceRequests-messages-Attachment-AttachmentsPreview-item-patch-request
Type: object
Show Source
Nested Schema : schema
Type: object
Show Source
  • Title: Display Name
    Maximum Length: 400
    The display name of the channel.
  • Title: Channel ID
    The unique identifier of the channel.
  • Title: Collaboration Resource Identifier
    The unique identifier of the collaboration network user that the internal users are communicating with.
  • Title: Contact Point ID
    The unique identifier of the contact point record of the contact who's being communicated with. A contact point is a contact's identifier for a specific channel of communication. For example, the contact point for the email channel would be an email address while the contact point of a person for twitter would be the twitter handle.
  • Title: Inbound Message Object Identifier
    The unique identifier of the inbound object that resulted in the creation of the service request.
  • Title: Object ID
    The unique identifier of the object. Depending on the object type, indicates the service request Id or the service request message Id associated with the channel communication.
  • Title: Party ID
    The unique party identifier of the person who's being communicated with.
  • Title: Party Endpoint
    Maximum Length: 1000
    The endpoint used to communicate with the customer contact. For example, email address, phone number, and so on. When Party_ID is NULL and PartyViaEndPoint is not NULL, the endpoint belongs to a party.
  • Title: Person ID
    The unique person ID of the contact.
  • Title: Post Identifier
    Maximum Length: 1000
    The unique identifier of the social media post record that was used to create the service request or the service request message.
  • Title: Routing Code
    Maximum Length: 30
    The code indicating how the message was routed through the endpoint. For example, if the endpoint is email address the field indicates if the recipient was a TO, a CC, or a BCC recipient.
Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Body ()
Root Schema : internalServiceRequests-messages-item-response
Type: object
Show Source
  • Attachments
    Title: Attachments
    The attachments resource is used to view, create, and update attachments.
  • Service Request Communications
    Title: Service Request Communications
    The channel communications resource is used to view, create, update, and delete a communication. It contains information about the communication between support agents and workers. For example, the type of information recorded about communications include message identifiers, contact identifiers, and contact point identifiers.
  • Title: Channel
    The unique identifier of the channel.
  • Title: Channel Type
    Maximum Length: 30
    The channel type, such a email, phone, social, and so on.
  • Title: Collaboration Resource
    The unique identifier of the collaboration network user that the internal users are communicating with.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    The user who created the message.
  • Title: Created by Email ID
    Read Only: true
    Maximum Length: 320
    The email Id of the person who created the service request message.
  • Title: Created by Party ID
    Read Only: true
    Maximum Length: 80
    The unique party identifier of the person who created the service request message.
  • Title: Creation Date
    Read Only: true
    The date and time when the message was created.
  • Title: Can Delete
    Read Only: true
    Indicates whether the user has access to delete the record.
  • Title: Last Updated Date
    Read Only: true
    The date and time when the message was last updated.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    The user who last updated the message.
  • Title: Last Update Login
    Read Only: true
    Maximum Length: 32
    The login of the user who last updated the message.
  • Links
  • Title: Message Content
    The content of the service request message.
  • Title: Created By
    Maximum Length: 64
    The user who created the message in the original source system. This is applicable if the service request message was imported from another system.
  • Title: Message Expand State
    The message expanding state.
  • Title: Message ID
    The unique identifier of the service request message.
  • Title: Last Updated Date
    The date when the message was last updated in the original source system. This is applicable if the service request message was imported from another system.
  • Title: Last Updated By
    Maximum Length: 64
    The user who last updated the message in the original source system. This is applicable if the service request message was imported from another system.
  • Title: Last Update Login
    Maximum Length: 32
    The login of the user who last updated the message in the original source system. This is applicable if the service request message was imported from another system.
  • Title: Message Number
    Maximum Length: 30
    The public unique identifier of the service request message.
  • Title: Message Subtype
    Maximum Length: 30
    The service request message subtype.
  • Title: Message Type Code
    Maximum Length: 30
    The message type. The accepted values are Response, Customer Entry, System Note, System Response, and Internal Note.
  • Title: Network
    Read Only: true
    Maximum Length: 30
    The type of social network.
  • Title: Notification Processing Status Code
    Maximum Length: 30
    The notification processing status code.
  • Title: Notification Retry Count
    The notification retry count.
  • Title: Object ID
    The unique identifier of the object.
  • Title: Object Type Code
    Maximum Length: 30
    Default Value: SVC_SR_MESSAGES
    The code indicating whether the channel communication record is associated to the service request or the service request message. A list of accepted values is defined in the lookup ORA_SVC_CHANNEL_OBJECT_TYPE_CD.
  • Title: Original System
    Maximum Length: 255
    The unique identifier of the message record in the original source system from where the message was imported. This is applicable if the service request message was imported from another system.
  • Title: Origination Date
    The date the message was created in the original source system. This is applicable if the service request message was imported from another system.
  • Title: Parent Message ID
    The unique identifier of the parent message.
  • Title: Posted By
    Read Only: true
    Maximum Length: 360
    The party name of the user who posted the message. The user can be an internal resource or a customer contact.
  • Title: Posted by ID
    The unique identifier of the user who the posted the message. The user can be an internal resource or a customer contact.
  • Title: Posted by Party Number
    Read Only: true
    Maximum Length: 30
    The alternative key for the party identifier of the person posting the service request message.
  • Title: Contains PII Data
    Maximum Length: 1
    Indicates whether the message contains personally identifiable information.
  • Title: Processing ID
    Read Only: true
    The unique identifier of the processing.
  • Title: Processing Status
    Maximum Length: 30
    Default Value: ORA_SVC_READY
    The processing status of the message. The accepted values are Ready, Processing, Error, and Success.
  • Title: Reply to Message ID
    Read Only: true
    The unique identifier of the customer message to which the agent is replying to.
  • Title: Rich Text
    Maximum Length: 1
    Default Value: true
    Indicates whether the message content is in rich text format. If the format is rich text, then the value is Y, else the value is N.
  • Title: Root Message Identifier
    Read Only: true
    The identifier of the root message in the message hierarchy.
  • Title: Root Message Thread Count
    Read Only: true
    The number of messages under a root message in a service request.
  • Title: Root Message Thread Last Updated Date
    Read Only: true
    The last updated date for all messages under the root message in a service request.
  • Title: Root Thread Message Last Updated Date
    Read Only: true
    The date when all messages under the root message in a service request were last updated.
  • Title: Sent Date
    The date and time when the message was sent.
  • Title: Private Message
    Maximum Length: 1
    Indicates whether the service request was created from a private social post.
  • Title: Source Code
    Maximum Length: 30
    The source of the message.
  • Title: Service Request Business Unit
    Read Only: true
    The identifier of the business unit associated with the service request.
  • Title: Service Request ID
    The unique identifier of the service request to which the message is associated.
  • Title: Inline Attachment Identifiers
    Maximum Length: 1000
    The list of inline attachment identifiers associated with the service request
  • Title: Service Request Number
    Maximum Length: 30
    The alternative key for the service request number.
  • Title: Service Request Application Stripe
    Read Only: true
    Maximum Length: 30
    The application stripe of the service request.
  • Title: Status Code
    Maximum Length: 30
    The status of the message. The accepted values are Draft, Committed, and Corrected.
  • Title: Subject
    Maximum Length: 1000
    The subject of the service request message.
  • Title: Template Name
    Maximum Length: 240
    The name of the template that's used for outbound communication of the message.
  • Title: Thread Count
    Read Only: true
    The number of threads in a service request message.
  • Title: Thread Hierarchy Level
    Read Only: true
    The thread hierarchy level.
  • Title: Thread Identifier
    Read Only: true
    The unique identifier of the service request message thread.
  • Title: Thread Last Updated Date
    Read Only: true
    The date when the thread was last updated.
  • Title: Thread Message Last Updated Date
    Read Only: true
    The date when the thread message was last updated.
  • Title: Can Update
    Read Only: true
    Indicates whether the user has access to update the record.
  • Title: Visibility Code
    Maximum Length: 30
    The privacy level of the message. The accepted values are Internal and External. Null value indicates that the message is External.
Nested Schema : Attachments
Type: array
Title: Attachments
The attachments resource is used to view, create, and update attachments.
Show Source
Nested Schema : Service Request Communications
Type: array
Title: Service Request Communications
The channel communications resource is used to view, create, update, and delete a communication. It contains information about the communication between support agents and workers. For example, the type of information recorded about communications include message identifiers, contact identifiers, and contact point identifiers.
Show Source
Nested Schema : internalServiceRequests-messages-Attachment-item-response
Type: object
Show Source
Nested Schema : AttachmentsDFFVL
Type: array
Show Source
Nested Schema : Attachments Preview
Type: array
Title: Attachments Preview
The attachments preview resource is used to preview the attachment pages.
Show Source
Nested Schema : internalServiceRequests-messages-Attachment-AttachmentsDFFVL-item-response
Type: object
Show Source
Nested Schema : internalServiceRequests-messages-Attachment-AttachmentsPreview-item-response
Type: object
Show Source
Nested Schema : internalServiceRequests-messages-channelCommunication-item-response
Type: object
Show Source
  • Title: Account Name
    Read Only: true
    Maximum Length: 400
    The account name associated with the channel. For example, for email the account name would be the inbound mailbox for support.
  • Title: Display Name
    Maximum Length: 400
    The display name of the channel.
  • Title: Channel ID
    The unique identifier of the channel.
  • Title: Channel Short Name
    Maximum Length: 450
    The public unique identifier of the channel.
  • Title: Channel Type
    Read Only: true
    Maximum Length: 30
    The code indicating the channel type. For example, email, phone, social, and so on. A list of accepted values is defined in the lookup ORA_SVC_CHANNEL_TYPE_CD.
  • Title: Collaboration ID
    Read Only: true
    Maximum Length: 255
    The unique identifier of the collaboration network user in the corresponding network. An example of this is the slack user Id of a user.
  • Title: Resource Name
    Read Only: true
    Maximum Length: 400
    The user name of the external user on the collaboration network.
  • Title: Collaboration Resource Identifier
    The unique identifier of the collaboration network user that the internal users are communicating with.
  • Title: Contact Point ID
    The unique identifier of the contact point record of the contact who's being communicated with. A contact point is a contact's identifier for a specific channel of communication. For example, the contact point for the email channel would be an email address while the contact point of a person for twitter would be the twitter handle.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    The user who created the communication channel.
  • Title: Creation Date
    Read Only: true
    The date and time when the communication channel was created.
  • Title: Inbound Message Object Identifier
    The unique identifier of the inbound object that resulted in the creation of the service request.
  • Title: Last Updated Date
    Read Only: true
    The date and time when the communication channel was last updated.
  • Title: Updated By
    Read Only: true
    Maximum Length: 64
    The user who last updated the communication channel.
  • Title: Update Login
    Read Only: true
    Maximum Length: 32
    The session login associated to the user who last updated the communication channel.
  • Links
  • Title: Message Number
    Read Only: true
    Maximum Length: 30
    The public unique identifier of the service request message.
  • Title: Network
    Read Only: true
    Maximum Length: 30
    The code indicating the social network of the post. For example, Facebook, Twitter. A list of accepted values is defined in the lookup HZ_INSTANT_MESSENGER_TYPE.
  • Title: Object ID
    The unique identifier of the object. Depending on the object type, indicates the service request Id or the service request message Id associated with the channel communication.
  • Title: Object Type
    Read Only: true
    Maximum Length: 30
    Default Value: SVC_SR_MESSAGES
    The code indicating whether the channel communication record is associated to the service request or the service request message. A list of accepted values is defined in the lookup ORA_SVC_CHANNEL_OBJECT_TYPE_CD.
  • Title: Party ID
    The unique party identifier of the person who's being communicated with.
  • Title: Party Name
    Read Only: true
    Maximum Length: 360
    The party name of the person who's being communicated with.
  • Title: Party Number
    Read Only: true
    Maximum Length: 30
    The public unique identifier of the contact associated with the service request message.
  • Title: Party Endpoint
    Maximum Length: 1000
    The endpoint used to communicate with the customer contact. For example, email address, phone number, and so on. When Party_ID is NULL and PartyViaEndPoint is not NULL, the endpoint belongs to a party.
  • Title: Person ID
    The unique person ID of the contact.
  • Title: Post Identifier
    Maximum Length: 1000
    The unique identifier of the social media post record that was used to create the service request or the service request message.
  • Title: Resource ID
    Read Only: true
    The unique identifier of the resource associated with the service request. This is a foreign key that can identify the collaboration network user the internal users are communicating with.
  • Title: Resource Type
    Read Only: true
    Maximum Length: 30
    The code indicating the type of the collaborative network user, such as USER, PUBLIC_CHANNEL, or PRIVATE_CHANNEL. A list of accepted values is defined in the lookup ORA_SVC_COLLAB_RES_TYPE_CD.
  • Title: Routing Code
    Maximum Length: 30
    The code indicating how the message was routed through the endpoint. For example, if the endpoint is email address the field indicates if the recipient was a TO, a CC, or a BCC recipient.
  • Title: ID
    Read Only: true
    The unique identifier of the service request channel communication record.
Back to Top