---
title: "Create a new topic"
method: POST
path: "/topics"
tags: ["topics and comments - resource"]
---

# Create a new topic

`POST /topics`

This API allows users to initiate a new topic for discussions and comments. To create a topic, the user must have access to the resource.

## Request body

- PublicTopicDto
  - `defaultTopic` boolean — True if this is the default topic for the specified resource. There should only be 1 topic with this field set per resource. Must be provided while creating a topic only.
  - `resource` PublicResource
    - `owner` string, required — ID of an organization that owns the resource
    - `type` 'ANALYSIS' | 'CATALOG' | 'COLUMN' | 'DATABASE' | 'DATASET' | 'DATASET_INSIGHT' | 'GLOSSARY' | 'GROUP' | 'METADATA_RESOURCE' | 'TABLE', required
  - `title` string
  - `topicId` string — Short friendly form of a topic id that uniquely identifies the topic within a resource.
  - `topicSlug` string — Short friendly form of a topic title.
  - `topicUuid` string, uuid — Unique id of the topic generated while create new one. Returned for reference but must be provided through URL only.
  - `visibility` 'DISCOVERABLE' | 'OPEN' | 'PRIVATE' — Topic visibility. The field is required.

## Response `200`

default response

- PublicTopicDto
  - `defaultTopic` boolean — True if this is the default topic for the specified resource. There should only be 1 topic with this field set per resource. Must be provided while creating a topic only.
  - `resource` PublicResource
    - `owner` string, required — ID of an organization that owns the resource
    - `type` 'ANALYSIS' | 'CATALOG' | 'COLUMN' | 'DATABASE' | 'DATASET' | 'DATASET_INSIGHT' | 'GLOSSARY' | 'GROUP' | 'METADATA_RESOURCE' | 'TABLE', required
  - `title` string
  - `topicId` string — Short friendly form of a topic id that uniquely identifies the topic within a resource.
  - `topicSlug` string — Short friendly form of a topic title.
  - `topicUuid` string, uuid — Unique id of the topic generated while create new one. Returned for reference but must be provided through URL only.
  - `visibility` 'DISCOVERABLE' | 'OPEN' | 'PRIVATE' — Topic visibility. The field is required.

---

[API](https://skmtc.net/data/apis/data-world-public-api.md) · [All operations](https://skmtc.net/data/apis/data-world-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/data/data-world-public-api/versions/0a0cb1f94dad/schema)