---
title: "POST /conversations.setTopic"
method: POST
path: "/conversations.setTopic"
tags: ["conversations"]
---

# POST /conversations.setTopic

`POST /conversations.setTopic`

Sets the topic for a conversation.

## Headers

- `token` string

## Response `200`

Typical success response

- object — Schema for successful response from conversations.setTopic method
  - `channel` union[], required
    - union
      - object
        - `accepted_user` string
        - `connected_team_ids` DefsWorkspaceId[]
        - `conversation_host_id` string
        - `created` integer, required
        - `creator` string, required
        - `display_counts` object
          - `display_counts` integer, required
          - `guest_counts` integer, required
        - `enterprise_id` string
        - `has_pins` boolean
        - `id` string, required
        - `internal_team_ids` DefsTeam[]
        - `is_archived` boolean, required
        - `is_channel` boolean, required
        - `is_ext_shared` boolean
        - `is_frozen` boolean
        - `is_general` boolean, required
        - `is_global_shared` boolean
        - `is_group` boolean, required
        - `is_im` boolean, required
        - `is_member` boolean
        - `is_moved` integer
        - `is_mpim` false, required
        - `is_non_threadable` boolean
        - `is_open` boolean
        - `is_org_default` boolean
        - `is_org_mandatory` boolean
        - `is_org_shared` boolean, required
        - `is_pending_ext_shared` boolean
        - `is_private` boolean, required
        - `is_read_only` boolean
        - `is_shared` boolean, required
        - `is_starred` boolean
        - `is_thread_only` boolean
        - `last_read` string
        - `latest` union[]
          - union
            - ObjsMessage
              - …
            - unknown
        - `members` DefsUserId[]
        - `name` string, required
        - `name_normalized` string, required
        - `num_members` integer
        - `parent_conversation` union[]
          - union
            - string
            - unknown
        - `pending_connected_team_ids` DefsTeam[]
        - `pending_shared` DefsTeam[]
        - `pin_count` integer
        - `previous_names` DefsChannelName[]
        - `priority` number
        - `purpose` object, required
          - `creator` string, required
          - `last_set` integer, required
          - `value` string, required
        - `shared_team_ids` DefsTeam[]
        - `shares` object[]
          - `accepted_user` string
          - `is_active` boolean, required
          - `team` ObjsTeam, required
            - `archived` boolean
            - `avatar_base_url` string, uri
            - `created` integer
            - `date_create` integer
            - `deleted` boolean
            - `description` string, nullable
            - `discoverable` union[]
              - …
            - `domain` string, required
            - `email_domain` string, required
            - `enterprise_id` string
            - `enterprise_name` string
            - `external_org_migrations` ObjsExternalOrgMigrations
              - …
            - `has_compliance_export` boolean
            - `icon` ObjsIcon, required
              - …
            - `id` string, required
            - `is_assigned` boolean
            - `is_enterprise` integer
            - `is_over_storage_limit` boolean
            - `limit_ts` integer
            - `locale` string
            - `messages_count` integer
            - `msg_edit_window_mins` integer
            - `name` string, required
            - `over_integrations_limit` boolean
            - `over_storage_limit` boolean
            - `pay_prod_cur` string
            - `plan` '' | 'std' | 'plus' | 'compliance' | 'enterprise'
            - `primary_owner` ObjsPrimaryOwner
              - …
            - `sso_provider` object
              - …
          - `user` string, required
        - `timezone_count` integer
        - `topic` object, required
          - `creator` string, required
          - `last_set` integer, required
          - `value` string, required
        - `unlinked` integer
        - `unread_count` integer
        - `unread_count_display` integer
        - `use_case` string
        - `user` string
        - `version` integer
      - object
        - `accepted_user` string
        - `connected_team_ids` DefsTeam[]
        - `conversation_host_id` string
        - `created` integer, required
        - `creator` string, required
        - `display_counts` object
          - `display_counts` integer, required
          - `guest_counts` integer, required
        - `id` string, required
        - `internal_team_ids` DefsTeam[]
        - `is_archived` boolean, required
        - `is_channel` boolean, required
        - `is_ext_shared` boolean
        - `is_frozen` boolean
        - `is_general` boolean, required
        - `is_group` boolean, required
        - `is_im` boolean, required
        - `is_member` boolean
        - `is_moved` integer
        - `is_mpim` true, required
        - `is_non_threadable` boolean
        - `is_open` boolean
        - `is_org_shared` boolean, required
        - `is_pending_ext_shared` boolean
        - `is_private` boolean, required
        - `is_read_only` boolean
        - `is_shared` boolean, required
        - `is_starred` boolean
        - `is_thread_only` boolean
        - `last_read` string
        - `latest` union[]
          - union
            - ObjsMessage
              - …
            - unknown
        - `members` DefsUserId[]
        - `name` string, required
        - `name_normalized` string, required
        - `num_members` integer
        - `parent_conversation` union[]
          - union
            - string
            - unknown
        - `pending_connected_team_ids` DefsTeam[]
        - `pending_shared` DefsTeam[]
        - `pin_count` integer
        - `previous_names` DefsChannelName[]
        - `priority` number
        - `purpose` object, required
          - `creator` string, required
          - `last_set` integer, required
          - `value` string, required
        - `shared_team_ids` DefsTeam[]
        - `shares` object[]
          - `accepted_user` string
          - `is_active` boolean, required
          - `team` ObjsTeam, required
            - `archived` boolean
            - `avatar_base_url` string, uri
            - `created` integer
            - `date_create` integer
            - `deleted` boolean
            - `description` string, nullable
            - `discoverable` union[]
              - …
            - `domain` string, required
            - `email_domain` string, required
            - `enterprise_id` string
            - `enterprise_name` string
            - `external_org_migrations` ObjsExternalOrgMigrations
              - …
            - `has_compliance_export` boolean
            - `icon` ObjsIcon, required
              - …
            - `id` string, required
            - `is_assigned` boolean
            - `is_enterprise` integer
            - `is_over_storage_limit` boolean
            - `limit_ts` integer
            - `locale` string
            - `messages_count` integer
            - `msg_edit_window_mins` integer
            - `name` string, required
            - `over_integrations_limit` boolean
            - `over_storage_limit` boolean
            - `pay_prod_cur` string
            - `plan` '' | 'std' | 'plus' | 'compliance' | 'enterprise'
            - `primary_owner` ObjsPrimaryOwner
              - …
            - `sso_provider` object
              - …
          - `user` string, required
        - `timezone_count` integer
        - `topic` object, required
          - `creator` string, required
          - `last_set` integer, required
          - `value` string, required
        - `unlinked` integer
        - `unread_count` integer
        - `unread_count_display` integer
        - `user` string
        - `version` integer
      - object
        - `created` integer, required
        - `has_pins` boolean
        - `id` string, required
        - `is_archived` boolean
        - `is_ext_shared` boolean
        - `is_frozen` boolean
        - `is_im` boolean, required
        - `is_open` boolean
        - `is_org_shared` boolean, required
        - `is_shared` boolean
        - `is_starred` boolean
        - `is_user_deleted` boolean
        - `last_read` string
        - `latest` union[]
          - union
            - ObjsMessage
              - …
            - unknown
        - `parent_conversation` union[]
          - union
            - string
            - unknown
        - `pin_count` integer
        - `priority` number, required
        - `shares` object[]
          - `date_create` integer, required
          - `id` string, required
          - `is_active` boolean, required
          - `name` string, required
          - `team` ObjsTeam, required
            - `archived` boolean
            - `avatar_base_url` string, uri
            - `created` integer
            - `date_create` integer
            - `deleted` boolean
            - `description` string, nullable
            - `discoverable` union[]
              - …
            - `domain` string, required
            - `email_domain` string, required
            - `enterprise_id` string
            - `enterprise_name` string
            - `external_org_migrations` ObjsExternalOrgMigrations
              - …
            - `has_compliance_export` boolean
            - `icon` ObjsIcon, required
              - …
            - `id` string, required
            - `is_assigned` boolean
            - `is_enterprise` integer
            - `is_over_storage_limit` boolean
            - `limit_ts` integer
            - `locale` string
            - `messages_count` integer
            - `msg_edit_window_mins` integer
            - `name` string, required
            - `over_integrations_limit` boolean
            - `over_storage_limit` boolean
            - `pay_prod_cur` string
            - `plan` '' | 'std' | 'plus' | 'compliance' | 'enterprise'
            - `primary_owner` ObjsPrimaryOwner
              - …
            - `sso_provider` object
              - …
        - `unread_count` integer
        - `unread_count_display` integer
        - `user` string, required
        - `version` integer
  - `ok` true, required

## Other responses

- `default` — Typical error response

---

[API](https://skmtc.net/slack/apis/web-api.md) · [All operations](https://skmtc.net/slack/apis/web-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/slack/web-api/versions/7b951462b44f/schema)