Update a channel

patch

/crmRestApi/resources/11.13.18.05/channels/{ChannelId}

Request

Path Parameters
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
  • Title: Access Token
    Maximum Length: 400
    The access token used for the social channel.
  • Title: Account Name
    Maximum Length: 400
    The name of the account associated with the channel.
  • Title: API
    Maximum Length: 400
    The unique identifier of the channel API.
  • Title: API Password
    Maximum Length: 400
    The password for the channel API.
  • Title: API Version
    Maximum Length: 400
    The API version of the channel.
  • Title: Authentication URL
    Maximum Length: 1000
    The uniform resource locator of the channel authentication.
  • Title: Authorization URL
    Maximum Length: 1000
    The uniform resource locator of the channel authorization.
  • Title: Authorization Token
    Maximum Length: 400
    The authorization token used for the social channel.
  • Title: Business Unit ID
    The unique identifier of the business unit associated with the channel.
  • Title: Business Unit Name
    Maximum Length: 255
    The name of the business unit associated with the channel.
  • Title: Customer Type
    Maximum Length: 30
    The type of customers expected to send a message to the channel, such as Consumer, Business, or Both.
  • Title: Display Name
    Maximum Length: 400
    The display name of the channel.
  • Title: Active
    Maximum Length: 1
    Default Value: true
    Indicates whether the channel is active. The default value is true.
  • Title: Endpoint
    Maximum Length: 1000
    The endpoint of the channel.
  • Title: Include Sender Email
    Maximum Length: 1
    Default Value: false
    Indicates whether the sender's email address should be included in the outbound message.
  • Title: Include Sender Name
    Maximum Length: 1
    Default Value: false
    Indicates whether the sender's name should be included in the outbound message.
  • Title: If Multiple Matches Found for Sender
    Maximum Length: 30
    The action the application should take if multiple matches are found for the message sender, such as Select None or Select First Match.
  • Title: Network
    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: If No Matches Found for Sender
    Maximum Length: 30
    The action the application should take if no matches are found for the message sender, such as Nothing or Create Contact.
  • Title: Original System
    Maximum Length: 255
    The original system of reference for a channel that was imported.
  • Title: Port
    Maximum Length: 10
    The port associated with the channel.
  • Title: Private Conversation Allowed
    Maximum Length: 1
    Default Value: true
    Indicates whether the channel allows private messages. The default value is true.
  • Title: Purpose
    Maximum Length: 30
    The purpose of the channel such as Support, Sales, Inquiry.
  • Title: Refresh Token
    Maximum Length: 400
    The refresh token used for the social channel.
  • Channel Resources
    Title: Channel Resources
    The channel resources is used to view, create, update, and delete the list of employees or partners, such as service representatives or service managers, who are associated with a service channel. If a resource is associated with a channel, then they can communicate with the customer using that channel.
  • Sender Identification Priorities
    Title: Sender Identification Priorities
    The sender identification priorities resource is used to view, create, update, and delete identification priorities for channels.The sender identification priority is used to resolve a conflict if multiple party identifiers are found for a sender of a message.
  • Title: Source Code
    Maximum Length: 30
    Default Value: ORA_SVC_ADMIN_UI
    The source interface for the channel creation.
  • Title: Stripe Code
    Maximum Length: 30
    The code indicating the application stripe of the service request category. A list of accepted values is defined in the lookup ORA_SVC_STRIPE_CD.
  • Title: Token Access URL
    Maximum Length: 1000
    The channel token access URL.
  • Title: Token Request URL
    Maximum Length: 1000
    The URL to pass a token request on the channel.
Nested Schema : Channel Resources
Type: array
Title: Channel Resources
The channel resources is used to view, create, update, and delete the list of employees or partners, such as service representatives or service managers, who are associated with a service channel. If a resource is associated with a channel, then they can communicate with the customer using that channel.
Show Source
Nested Schema : Sender Identification Priorities
Type: array
Title: Sender Identification Priorities
The sender identification priorities resource is used to view, create, update, and delete identification priorities for channels.The sender identification priority is used to resolve a conflict if multiple party identifiers are found for a sender of a message.
Show Source
Nested Schema : schema
Type: object
Show Source
Nested Schema : schema
Type: object
Show Source
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 : channels-item-response
Type: object
Show Source
  • Title: Access Token
    Maximum Length: 400
    The access token used for the social channel.
  • Title: Account Name
    Maximum Length: 400
    The name of the account associated with the channel.
  • Title: API
    Maximum Length: 400
    The unique identifier of the channel API.
  • Title: API Password
    Maximum Length: 400
    The password for the channel API.
  • Title: API Version
    Maximum Length: 400
    The API version of the channel.
  • Title: Authentication URL
    Maximum Length: 1000
    The uniform resource locator of the channel authentication.
  • Title: Authorization URL
    Maximum Length: 1000
    The uniform resource locator of the channel authorization.
  • Title: Authorization Token
    Maximum Length: 400
    The authorization token used for the social channel.
  • Title: Business Unit ID
    The unique identifier of the business unit associated with the channel.
  • Title: Business Unit Name
    Maximum Length: 255
    The name of the business unit associated with the channel.
  • Title: Channel
    Read Only: true
    The unique identifier of the channel.
  • Title: Channel Code
    Maximum Length: 450
    The short name of the channel.
  • Title: Channel Type
    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.
  • Read Only: true
    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: Created By
    Read Only: true
    Maximum Length: 64
    The user who created the channel.
  • Title: Creation Date
    Read Only: true
    The date when the channel was created.
  • Title: Customer Type
    Maximum Length: 30
    The type of customers expected to send a message to the channel, such as Consumer, Business, or Both.
  • Read Only: true
    Indicates if the channel has been deleted. The default value is false.
  • Title: Display Name
    Maximum Length: 400
    The display name of the channel.
  • Title: Active
    Maximum Length: 1
    Default Value: true
    Indicates whether the channel is active. The default value is true.
  • Title: Endpoint
    Maximum Length: 1000
    The endpoint of the channel.
  • Title: Include Sender Email
    Maximum Length: 1
    Default Value: false
    Indicates whether the sender's email address should be included in the outbound message.
  • Title: Include Sender Name
    Maximum Length: 1
    Default Value: false
    Indicates whether the sender's name should be included in the outbound message.
  • Title: Last Updated Date
    Read Only: true
    The date when the channel was last updated.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    The user who last updated the channel.
  • Title: Last Update Login
    Read Only: true
    Maximum Length: 32
    The login of the user who last updated the channel.
  • Links
  • Title: If Multiple Matches Found for Sender
    Maximum Length: 30
    The action the application should take if multiple matches are found for the message sender, such as Select None or Select First Match.
  • Title: Network
    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: If No Matches Found for Sender
    Maximum Length: 30
    The action the application should take if no matches are found for the message sender, such as Nothing or Create Contact.
  • Read Only: true
    The number of service requests that are neither deleted nor closed.
  • Title: Original System
    Maximum Length: 255
    The original system of reference for a channel that was imported.
  • Title: Port
    Maximum Length: 10
    The port associated with the channel.
  • Title: Private Conversation Allowed
    Maximum Length: 1
    Default Value: true
    Indicates whether the channel allows private messages. The default value is true.
  • Title: Purpose
    Maximum Length: 30
    The purpose of the channel such as Support, Sales, Inquiry.
  • Title: Refresh Token
    Maximum Length: 400
    The refresh token used for the social channel.
  • Channel Resources
    Title: Channel Resources
    The channel resources is used to view, create, update, and delete the list of employees or partners, such as service representatives or service managers, who are associated with a service channel. If a resource is associated with a channel, then they can communicate with the customer using that channel.
  • Sender Identification Priorities
    Title: Sender Identification Priorities
    The sender identification priorities resource is used to view, create, update, and delete identification priorities for channels.The sender identification priority is used to resolve a conflict if multiple party identifiers are found for a sender of a message.
  • Title: Source Code
    Maximum Length: 30
    Default Value: ORA_SVC_ADMIN_UI
    The source interface for the channel creation.
  • Title: Stripe Code
    Maximum Length: 30
    The code indicating the application stripe of the service request category. A list of accepted values is defined in the lookup ORA_SVC_STRIPE_CD.
  • Title: Token Access URL
    Maximum Length: 1000
    The channel token access URL.
  • Title: Token Request URL
    Maximum Length: 1000
    The URL to pass a token request on the channel.
  • Read Only: true
    Indicates if the channel has been updated. The default value is false.
Nested Schema : Channel Resources
Type: array
Title: Channel Resources
The channel resources is used to view, create, update, and delete the list of employees or partners, such as service representatives or service managers, who are associated with a service channel. If a resource is associated with a channel, then they can communicate with the customer using that channel.
Show Source
Nested Schema : Sender Identification Priorities
Type: array
Title: Sender Identification Priorities
The sender identification priorities resource is used to view, create, update, and delete identification priorities for channels.The sender identification priority is used to resolve a conflict if multiple party identifiers are found for a sender of a message.
Show Source
Nested Schema : channels-resourceMembers-item-response
Type: object
Show Source
Nested Schema : channels-senderIdentificationPriorities-item-response
Type: object
Show Source
Back to Top

Examples

Use PATCH with the following URI syntax to update details of a specific channel:

Example of Request URI

The following shows an example of the request URL.

https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/channels/300100095223514

Example of Request Header

The following shows an example of the request header.

PATCH /crmRestApi/resources/11.13.18.05/channels/300100095223514 HTTP/1.1
HOST: servername.fa.us2.oraclecloud.com
authorization: Basic U0FMRVNfQURNSU46V2VsY29tZTE=
content-type: application/vnd.oracle.adf.resourceitem+json

Example of Request Body

The following shows an example of the request body in JSON format.

Content type:
{
"ChannelTypeCd": "ORA_SVC_SOCIAL", 
"AccountName": "REST-03181052" 
}

Example of Response Header

The following shows an example of the response header.

HTTP/1.1 200: OK
Date: Mon, 12 Jan 2017 13:35:04 GMT
Server: Oracle-HTTP-Server-11g
Content-Type: application/vnd.oracle.adf.resourceitem+json
Content-Language: en

Example of Response Body

The following shows an example of the response body in JSON format.

Content type:
{
"ChannelId": 300100095223514,
"ChannelTypeCd": "ORA_SVC_EMAIL",
"NetworkTypeCd": null,
"AccountName": "REST-03181052",
"DisplayName": "REST-03181052",
"PrivatePToPAllowedFlag": true,
"OriginalSystemReference": null,
"EnabledFlag": true,
"CreatedBy": "SALES_ADMIN",
"CreationDate": "2017-01-12T02:18:13-08:00",
"LastUpdatedBy": "SALES_ADMIN",
"LastUpdateDate": "2017-01-12T02:25:52-08:00",
"LastUpdateLogin": null,
"EndPoint": null,
"Port": null,
"APIVersion": null,
"APIId": null,
"APIPassword": null,
"AuthenticationURL": null,
"AuthorizationURL": null,
"TokenRequestURL": null,
"TokenAccessURL": null,
"AccessToken": null,
"RefreshToken": null,
"AuthToken": null,
"OpenSrCount": null,
"ChannelTypeCdLovSwitcher": "LOV_ChannelTypeCd",
"StripeCd": "ORA_SVC_CRM",
"links": [
  {
"rel": "self",
"href": "http://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/channels/300100095223514",
"name": "channels",
"kind": "item",
"properties": {
"changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B020000787200106A6176612E6C616E672E4F626A656374000000000000000000000078700000000278"
}
},
  {
"rel": "canonical",
"href": "http://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/channels/300100095223514",
"name": "channels",
"kind": "item"
},
  {
"rel": "lov",
"href": "http://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/channels/300100095223514/lov/YesNoLOV",
"name": "YesNoLOV",
"kind": "collection"
},
  {
"rel": "lov",
"href": "http://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/channels/300100095223514/lov/NetworkTypeCdLOV",
"name": "NetworkTypeCdLOV",
"kind": "collection"
},
  {
"rel": "lov",
"href": "http://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/channels/300100095223514/lov/StripeCdLOV",
"name": "StripeCdLOV",
"kind": "collection"
},
  {
"rel": "lov",
"href": "http://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/channels/300100095223514/lov/ChannelTypeCdLOV",
"name": "ChannelTypeCdLOV",
"kind": "collection"
},
  {
"rel": "child",
"href": "http://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/channels/300100095223514/child/resourceMembers",
"name": "resourceMembers",
"kind": "collection"
}
],
}
Back to Top