---
title: "Create discussion thread"
method: POST
path: "/discussion-threads"
---

# Create discussion thread

`POST /discussion-threads`

## Request body

- CreateDiscussionThreadRequestBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `attributes` CreateDiscussionThreadAttributes, required
    - `analysisId` string
    - `initialMessage` string, required
    - `kind` 'comment' | 'question', required
    - `retrospectiveId` string
    - `targetId` string
    - `targetKind` 'finding' | 'knowledge_entity' | 'knowledge_relationship' | 'normalized_event'

## Response `200`

OK

- CreateDiscussionThreadResponseBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `data` DiscussionThread, required
    - `attributes` DiscussionThreadAttributes, required
      - `analysisId` string
      - `createdAt` string, date-time, required
      - `kind` 'comment' | 'question', required
      - `resolutionNote` string
      - `resolutionState` 'open' | 'resolved'
      - `resolvedAt` string, date-time
      - `resolvedById` string
      - `retrospectiveId` string
      - `targetId` string
      - `targetKind` 'finding' | 'knowledge_entity' | 'knowledge_relationship' | 'normalized_event'
      - `updatedAt` string, date-time, required
      - `userId` string, required
    - `id` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error
- `501` — Not Implemented

## Changes

- **2026-09-11** (v1) `ed03dea25301` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/rezible/apis/rezible-api/changes/discussion-threads/post.md)

---

[API](https://skmtc.dev/rezible/apis/rezible-api.md) · [All operations](https://skmtc.dev/rezible/apis/rezible-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rezible/apis/rezible-api/revisions/b1e1da7c37c7?raw)