---
title: "Get a thread"
method: GET
path: "/v2/threads/{thread_id}"
tags: ["Threads"]
---

# Get a thread

`GET /v2/threads/{thread_id}`

Get all comments in a thread.

To view threads on records, you will need the `object_configuration:read` and `record_permission:read` scopes.

To view threads on list entries, you will need the `list_configuration:read` and `list_entry:read` scopes.

Required scopes: `comment:read`.

## Path parameters

- `thread_id` string, uuid, required — A UUID which identifies the thread.

## Response `200`

Success

- object — Success
  - `data` Thread, required
    - `id` object, required
      - `workspace_id` string, uuid, required — The ID of the workspace the thread belongs to.
      - `thread_id` string, uuid, required — The ID of the thread.
    - `comments` Comment[], required — An array of comments in the thread, sorted by `created_at`.
      - `id` object, required
        - `workspace_id` string, uuid, required — The ID of the workspace the comment belongs to.
        - `comment_id` string, uuid, required — The ID of the comment.
      - `thread_id` string, uuid, required — The ID of the thread the comment belongs to.
      - `content_plaintext` string, required — A plaintext representation of the content of the comment. References to workspace members are cast into email addresses, all other stylistic elements are removed.
      - `entry` object, nullable, required — The entry the comment belongs to, `null` for comments on records.
        - `entry_id` string, uuid, required — The ID of the entry the comment belongs to.
        - `list_id` string, uuid, required — The ID of the list the entry belongs to.
      - `record` object, required — The record the comment belongs to.
        - `record_id` string, uuid, required — The ID of the record the comment belongs to.
        - `object_id` string, uuid, required — The ID of the object the record belongs to.
      - `resolved_at` string, nullable, required — Whether the comment is resolved.
      - `resolved_by` object, required — The actor that resolved this comment.
        - `id` string, nullable — An ID to identify the actor.
        - `type` 'api-token' | 'workspace-member' | 'system' | 'app', nullable — The type of actor. [Read more information on actor types here](/docs/actors).
      - `created_at` string, required — When the note was created.
      - `author` object, required — Who wrote this comment. Note that the API provides the ability for API tokens to write comments on behalf of other actors.
        - `id` string, nullable — An ID to identify the actor.
        - `type` 'api-token' | 'workspace-member' | 'system' | 'app', nullable — The type of actor. [Read more information on actor types here](/docs/actors).
    - `created_at` string, required — When the thread was created.

## Other responses

- `404` — Not Found

---

[API](https://skmtc.net/d-stoll/apis/attio-api.md) · [All operations](https://skmtc.net/d-stoll/apis/attio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/d-stoll/attio-api/versions/ebcf9b5c6aa3/schema)