> ## Documentation Index
> Fetch the complete documentation index at: https://help.withallo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Team discussion threads attached to calls, SMS, and conversation notes

The Threads API lets you manage **team discussion threads**. A thread is a comment chain attached to a single conversation item — a call, an SMS message, or a conversation note — where teammates discuss that item without the contact seeing anything.

## Key concepts

**One thread per item** — each conversation item can have at most one thread. Creating a second one returns `409` with code `THREAD_ALREADY_EXISTS`; find the existing thread and add a comment instead.

**Entity reference** — a thread points at its item through `entity_type` (`CALL`, `TEXT_MESSAGE`, or `CONVERSATION_NOTE`) and `entity_id` (the item's ID: `cll-*`, `msg-*`, or `not-*`).

**Comments** — a thread is created with a first comment and grows from there. Only a comment's author can edit it.

**Resolution** — threads can be marked resolved and reopened. Resolving does not lock the thread — comments can still be added.

**Mentions** — comments support the same `@[Display Name](usr-xxxx)` mentions as notes, with the same push, email, and in-app notifications. See the [mentions guide](/en/v2/api-reference/notes/overview#mentions).

## Webhooks

Subscribe to the `thread.created`, `thread.comment.created`, `thread.comment.updated`, `thread.resolved`, and `thread.unresolved` events. See the [Event catalog](/en/v2/api-reference/webhooks/event-catalog#threadcreated).

## Endpoints

<CardGroup cols={1}>
  <Card title="Get thread" href="/en/v2/api-reference/threads/get-thread">
    A thread with all its comments
  </Card>

  <Card title="Find thread" href="/en/v2/api-reference/threads/find-thread">
    Look up a conversation item's thread by entity type and ID
  </Card>

  <Card title="Create thread" href="/en/v2/api-reference/threads/create-thread">
    Start a thread on an item with a first comment
  </Card>

  <Card title="Create thread comment" href="/en/v2/api-reference/threads/create-comment">
    Add a comment to a thread
  </Card>

  <Card title="Update thread comment" href="/en/v2/api-reference/threads/update-comment">
    Edit a comment's content (author only)
  </Card>

  <Card title="Resolve thread" href="/en/v2/api-reference/threads/resolve-thread">
    Mark a thread as resolved
  </Card>

  <Card title="Unresolve thread" href="/en/v2/api-reference/threads/unresolve-thread">
    Reopen a resolved thread
  </Card>
</CardGroup>