Move Topic

Overview

  • This API moves an existing topic (source topic) and its contents from its parent topic to another parent topic (destination topic). All the subtopics of the source topic get moved along with it.
  • If the source topic is being moved to become a top level topic, then the destination topic ID specified in the request body must equal -1 (as the top level topic does not have any parent).
  • If the destination topic already contains a topic with the same name as the source topic in any supported language, this API would respond with 409 HTTP error code.

Permissions

  • The user must have 'Cut' action on 'Topic' resource.
  • The user sending the request should be from the same or shared department as the topic.

Preconditions

  • The destination topic ID must be different from the current parent topic ID.
  • The source and destination topics must belong to the same department. Moving topics between departments is not allowed. If the destination topic ID is -1, the source topic is moved within the same department.
  • The source topic ID must not be Auto Generated Topic.
  • The destination topic ID must not be Auto Generated Topic.
SecurityoAuthUser
Request
path Parameters
ID
required
string

Topic ID

Examples:
202200000002268
Request Body schema: application/json
required
object (parentTopic)
required
object (language)
Responses
201

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

406

Not acceptable

409

Conflict

412

Preconditions failed

500

Internal server error

post/topics/{ID}/move
Request samples
application/json
{
  • "parentTopic": {
    },
  • "language": {
    }
}
Response samples
application/json
{
  • "code": "400-101",
  • "developerMessage": "Unsupported query parameter(s) supplied: '<query_parameter>'."
}