Attach to a new topic

Your application can create an attachment to a new topic.

The TopicInput value object has the required name field for the topic name and optional parameters. The attachNewTopic task creates an attachment to a new topic. For information about the attachmentInput argument, see Common value objects.

• projectName—Name to categorize the topic (required if newProject is true), with a maximum length of 255 characters.
• description—Optional description, with a maximum length of 2000 characters.
• workteams—A list of work team names.
• newProject—A boolean set to True to create new project.
• templateId—ID for the topic template.

The server creates the topic with a default initial state but no values are set for any topics fields. Topic names are not unique. If a topic is created with the same name as an existing topic, the user might see multiple topics with the same name in the Topic drop-down list. A user can display the Select Topic dialog box to distinguish between different topics with the same name by viewing other fields associated with the topic.

If specified, the templateId field should have the ID of the topic template from the user's selection and is available from the TopicTemplateContext.

If you chose not to support projects in your user interface or do not display the Project drop-down list, if the user creates a topic, you must set the projectName field to Unassigned.

TopicInput JSON

  {
        "name" : "string",
        "description" : "string",
        "newProject" : "boolean",
        "projectName" : "string",
        "workteams" : ["string"],
	 “templateId” : “number”
    }

To create a new topic without an attachment, do not supply the "attachment" attribute

attachNewTopic JSON

To create an attachment to a new topic:

{
    "serviceContext": {
        TopicServiceContext object
    },
    "topicInput": {
	TopicInput object
    },
    "attachment": {
	AttachmentInput object
    }
}