Read a Channel
get
/content/management/api/v1.1/channels/{id}
Read a channel.
Request
Path Parameters
-
id: string
id of the channel.
Query Parameters
-
links(optional): string
This parameter accepts a comma-separated list of link names. By default, this parameter gives all the links applicable. Possible values are: self, canonical, describedby
Response
Supported Media Types
- application/json
200 Response
OK.
Root Schema : Channel
Type:
object
Channels
Show Source
-
channelAccessControls(optional):
array channelAccessControls
A list of channel access controls, allowed only for a secure regular channel. It currently allows the access control only for secure channels
-
channelTokens(optional):
array channelTokens
A list of tokens for the channel.
-
channelType(optional):
string
Allowed Values:
[ "public", "secure" ]
The type of the channel. -
createdBy(optional):
string
createdBy user of the channel.
-
createdDate(optional):
object date
date
-
description(optional):
string
Description of the channel.
-
id(optional):
string
id of the channel. It is a required property in the get response and put request whereas it is not required in the post request.
-
isSiteChannel(optional):
boolean
Checks whether the channel is site channel.
-
isSitePlanChannel(optional):
boolean
-
links(optional):
array links
Links
-
localizationPolicy(optional):
string
The localization policy of the channel.
-
name(optional):
string
Name of the channel. It is a required property in the get response and post/put request.
-
primaryChannelSupported(optional):
boolean
primaryChannelSupported
-
publishPolicy(optional):
string
Allowed Values:
[ "anythingPublished", "onlyApproved" ]
The publish policy of the channel. -
rankingPolicyContentTypes(optional):
array rankingPolicyContentTypes
The search ranking policy scope of the channel.
-
rankingPolicyDescriptorId(optional):
string
The search ranking policy descriptor ID of the channel.
-
rankingPolicyDescriptorName(optional):
string
The search ranking policy descriptor name of the channel.
-
repositories(optional):
array repositories
Repositories associated with the channel. It currently exposes only the default repository for a site channel.
-
roleName(optional):
string
Name of the user's role on the channel.
-
updatedBy(optional):
string
updatedBy user of the channel.
-
updatedDate(optional):
object date
date
Nested Schema : channelAccessControls
Type:
array
A list of channel access controls, allowed only for a secure regular channel. It currently allows the access control only for secure channels
Show Source
-
Array of:
object channelAccessControls
channelAccessControls
Nested Schema : channelTokens
Type:
array
A list of tokens for the channel.
Show Source
-
Array of:
object channelToken
channelToken
Nested Schema : rankingPolicyContentTypes
Type:
array
The search ranking policy scope of the channel.
Show Source
Nested Schema : repositories
Type:
array
Repositories associated with the channel. It currently exposes only the default repository for a site channel.
Show Source
-
Array of:
object RepositoryId
RepositoryId
Nested Schema : channelAccessControls
Type:
object
channelAccessControls
Show Source
-
type(optional):
string
Allowed Values:
[ "CLOUD_USERS", "SERVICE_USERS", "SPECIFIC_USERS" ]
Access Control Type to be granted, possible values are CLOUD_USERS, SERVICE_USERS, SPECIFIC_USERS and defaults to CLOUD_USERS -
users(optional):
array users
Specific users to which channel access control is provided, allowed only if the access control type is SPECIFC_USERS
Nested Schema : users
Type:
array
Specific users to which channel access control is provided, allowed only if the access control type is SPECIFC_USERS
Show Source
-
Array of:
object UserId
UserId
Nested Schema : UserId
Type:
object
UserId
Show Source
-
groupType(optional):
string
Allowed Values:
[ "CEC", "IDP" ]
-
name(optional):
string
-
type(optional):
string
Allowed Values:
[ "user", "group" ]
Nested Schema : channelToken
Type:
object
channelToken
Show Source
-
expirationDate(optional):
object date
date
-
name(optional):
string
Name of the token.
-
token(optional):
string
Value of the token.
Nested Schema : Link
Type:
object
Link of the resource.
Show Source
-
href(optional):
string
The target resource's URI. It could be template URI. It is a required property in the get response.
-
mediaType(optional):
string
Media type.
-
method(optional):
string
What HTTP method can be used to access the target resource.
-
profile(optional):
string
Link to the metadata that describes the target resource.
-
rel(optional):
string
Relation type. It is a required property in the get response.
-
templated(optional):
boolean
Whether the URI is a template.
Nested Schema : RepositoryId
Type:
object
RepositoryId
Show Source
-
id(optional):
string
-
name(optional):
string
Name of the repository. It is a required property in the get response and post/put request.
304 Response
Not modified.
400 Response
Bad request.
403 Response
Forbidden.
404 Response
Not found.
500 Response
Internal server error.
Examples
The following example shows how to get a channel details using its ID by submission of a GET request on the REST resource using cURL:
curl -X GET -H 'Accept: application/json' 'https://host:port/content/management/api/v1.1/channels/{id}'
Example:
This reads a channel with id: CC3CF44049B94207BE552A345E74319B10F86A56D2F7.
/content/management/api/v1.1/channels/CC3CF44049B94207BE552A345E74319B10F86A56D2F7
Response Body
{ "id": "CC3CF44049B94207BE552A345E74319B10F86A56D2F7", "name": "channelName12", "description": "some channel description", "createdBy": "marketing.user", "createdDate": { "value": "2018-11-30T10:21:31.885Z", "timezone": "UTC" }, "updatedBy": "marketing.user", "updatedDate": { "value": "2018-11-30T10:21:31.885Z", "timezone": "UTC" }, "channelType": "public", "isSiteChannel": false, "publishPolicy": "anythingPublished", "localizationPolicy": "7B8F6F008D905491E0534DB0F70AEE4C", "channelTokens": [ { "name": "defaultToken", "name of the token.": "defaultToken", "value of the token.": "12b4e75643051cdc830b27d6d3503e44", "token": "12b4e75643051cdc830b27d6d3503e44", "expirationDate of the token.": { "value": "2098-12-28T00:00:00.000Z", "timezone": "UTC" }, "expirationDate": { "value": "2098-12-28T00:00:00.000Z", "timezone": "UTC" } } ], "links": [ { "href": "https://host:port/content/management/api/v1.1/channels/CC3CF44049B94207BE552A345E74319B10F86A56D2F7", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "https://host:port/content/management/api/v1.1/channels/CC3CF44049B94207BE552A345E74319B10F86A56D2F7", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "https://host:port/content/management/api/v1.1/metadata-catalog/channels/CC3CF44049B94207BE552A345E74319B10F86A56D2F7", "rel": "describedby", "method": "GET", "mediaType": "application/schema+json" } ] }