Managed Topics

Only community managers (users with the “Create and Set Up Communities” or “Manage Communities” permission) can create or reorder managed topics.

Resource

1/connect/communities/communityId/managed-topics

Available version

32.0

Requires Chatter

No

HTTP methods

GET, POST, PATCH, HEAD

Request parameters for GET

Parameter Name	Type	Description	Required or Optional	Available Version
depth	Integer	Specify an integer 1–3. If you specify 1, the children property of the Managed Topic response body is null. If you specify 2, the children property of the Managed Topic response body contains the direct children managed topics, if any, of the managed topic. If you specify 3, you get the direct children managed topics and their children managed topics if there are any. If depth isn’t specified, it defaults to 1.	Optional	35.0
managedTopic​Type	String	Type of managed topic. Featured—Topics that are featured, for example, on the community home page, but don’t provide overall navigation. Navigational—Topics that display in a navigational menu in the community. A topic can be associated with up to two managed topic types, so a topic can be both a Featured topic and a Navigational topic.	Optional Required if specifying recordId or depth	32.0
recordId	String	ID of the topic associated with the managed topics.	Optional	35.0

Response body for GET

Managed Topic Collection

Request body for POST

Root XML tag

<managedTopic>

JSON example using recordId

1{
2"managedTopicType" :"Navigational",
3"parentId” : "0mtR000000001KLIAY",
4"recordId" :"0TOD00000000cwk"
5}

JSON example using name

1{
2"name" :"Child Topic",
3"managedTopicType" :"Navigational",
4"parentId” : "0mtR000000001KLIAY"
5}

Properties

Name	Type	Description	Required or Optional	Available Version
managedTopic​Type	String	Type of managed topic. Featured—Topics that are featured, for example, on the community home page, but don’t provide overall navigation. Navigational—Topics that display in a navigational menu in the community. A topic can be associated with up to two managed topic types, so a topic can be both a Featured topic and a Navigational topic. You can create up to 25 managed topics per managedTopicType. To create a child managed topic, specify Navigational as the managedTopicType and specify a parentId.	Required	32.0
name	String	Name of the managed topic.	Required for new topics You must specify either name or recordId. You can’t specify both.	32.0
parentId	String	ID of the parent managed topic. If you specify a parentId, you must also specify Navigational as the managedTopicType. You can create up to three levels (parent, direct children, and their children) of managed topics and up to 10 children managed topics per managed topic.	Optional	35.0
recordId	String	ID of the record to become a managed topic. In version 32.0, recordId must be a topic ID.	Required for existing topics if the Name property isn’t used You must specify either name or recordId. You can’t specify both.	32.0

Request parameters for POST

Parameter Name	Type	Description	Required or Optional	Available Version
managedTopic​Type	String	Type of managed topic. Featured—Topics that are featured, for example, on the community home page, but don’t provide overall navigation. Navigational—Topics that display in a navigational menu in the community. A topic can be associated with up to two managed topic types, so a topic can be both a Featured topic and a Navigational topic. You can create up to 25 managed topics per managedTopicType. To create a child managed topic, specify Navigational as the managedTopicType and specify a parentId.	Required	32.0
name	String	Name of the managed topic.	Required for new topics You must specify either name or recordId. You can’t specify both.	32.0
parentId	String	ID of the parent managed topic. If you specify a parentId, you must also specify Navigational as the managedTopicType. You can create up to three levels (parent, direct children, and their children) of managed topics and up to 10 children managed topics per managed topic.	Optional	35.0
recordId	String	ID of the record to become a managed topic. In version 32.0, recordId must be a topic ID.	Required if the Name property isn’t used You must specify either name or recordId. You can’t specify both.	32.0

Response body for POST

Managed Topic

Request body for PATCH

Root XML tag

<managedTopicPositionCollection>

JSON example

1{
2"managedTopicPositions" : [
3  {
4    "managedTopicId" :"0mtD0000000001aIAA",
5    "position" :"0"
6  },
7  {
8    "managedTopicId" :"0mtD0000000002qIAA",
9    "position" :"2"
10  }
11  ]
12}

Properties

Name	Type	Description	Required or Optional	Available Version
managedTopic​Positions	Managed Topic Position Input[]	Collection of managed topic position request bodies. This collection can include Featured and Navigational managed topics and doesn’t need to include all managed topics. If you don’t include all managed topics in managedTopicPositions, the managed topics are reordered by respecting the positions indicated in managedTopicPositions and then by pushing down any managed topics that aren’t included in managedTopicPositions to the next available position. See Reorder managed topics example.	Required	32.0

Reorder managed topics example

If you have these managed topics:

Managed Topic	Position
ManagedTopicA	0
ManagedTopicB	1
ManagedTopicC	2
ManagedTopicD	3
ManagedTopicE	4

And you reorder managed topics by including this information in Managed Topic Position Collection Input:

Managed Topic	Position
ManagedTopicD	0
ManagedTopicE	2

The result is:

Managed Topic	Position
ManagedTopicD	0
ManagedTopicA	1
ManagedTopicE	2
ManagedTopicB	3
ManagedTopicC	4

Response body for PATCH

Managed Topic Collection