Topics¶

Topics can be used to categorize projects and find similar new projects.

Reference¶

This endpoint requires admin access for creating, updating and deleting objects.

List project topics on the GitLab instance:

topics = gl.topics.list()

Get a specific topic by its ID:

topic = gl.topics.get(topic_id)

Create a new topic:

topic = gl.topics.create({"name": "my-topic", "title": "my title"})

Update a topic:

topic.description = "My new topic"
topic.save()

# or
gl.topics.update(topic_id, {"description": "My new topic"})

Delete a topic:

topic.delete()

# or
gl.topics.delete(topic_id)

Merge a source topic into a target topic:

gl.topics.merge(topic_id, target_topic_id)