Get a thread

curl --request GET \
  --url https://api.attio.com/v2/threads/{thread_id} \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "id": {
      "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
      "thread_id": "a649e4d9-435c-43fb-83ba-847b4876f27a"
    },
    "comments": [
      {
        "id": {
          "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
          "comment_id": "aa1dc1d9-93ac-4c6c-987e-16b6eea9aab2"
        },
        "thread_id": "aa1dc1d9-93ac-4c6c-987e-16b6eea9aab2",
        "content_plaintext": "Let's go ahead and close this deal, [email protected].",
        "entry": {
          "entry_id": "2e6e29ea-c4e0-4f44-842d-78a891f8c156",
          "list_id": "33ebdbe9-e529-47c9-b894-0ba25e9c15c0"
        },
        "record": {
          "record_id": "bf071e1f-6035-429d-b874-d83ea64ea13b",
          "object_id": "97052eb9-e65e-443f-a297-f2d9a4a7f795"
        },
        "resolved_at": "2023-01-01T15:00:00.000000000Z",
        "resolved_by": {
          "type": "workspace-member",
          "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
        },
        "created_at": "2023-01-01T15:00:00.000000000Z",
        "author": {
          "type": "workspace-member",
          "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
        }
      }
    ],
    "created_at": "2023-01-01T15:00:00.000000000Z"
  }
}

GET

threads

{thread_id}

Get a thread

curl --request GET \
  --url https://api.attio.com/v2/threads/{thread_id} \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "id": {
      "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
      "thread_id": "a649e4d9-435c-43fb-83ba-847b4876f27a"
    },
    "comments": [
      {
        "id": {
          "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
          "comment_id": "aa1dc1d9-93ac-4c6c-987e-16b6eea9aab2"
        },
        "thread_id": "aa1dc1d9-93ac-4c6c-987e-16b6eea9aab2",
        "content_plaintext": "Let's go ahead and close this deal, [email protected].",
        "entry": {
          "entry_id": "2e6e29ea-c4e0-4f44-842d-78a891f8c156",
          "list_id": "33ebdbe9-e529-47c9-b894-0ba25e9c15c0"
        },
        "record": {
          "record_id": "bf071e1f-6035-429d-b874-d83ea64ea13b",
          "object_id": "97052eb9-e65e-443f-a297-f2d9a4a7f795"
        },
        "resolved_at": "2023-01-01T15:00:00.000000000Z",
        "resolved_by": {
          "type": "workspace-member",
          "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
        },
        "created_at": "2023-01-01T15:00:00.000000000Z",
        "author": {
          "type": "workspace-member",
          "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
        }
      }
    ],
    "created_at": "2023-01-01T15:00:00.000000000Z"
  }
}

Authorizations

Authorization

string

header

required

This API uses OAuth 2.0 with the authorization code grant flow.

Path Parameters

thread_id

string<uuid>

required

A UUID which identifies the thread.

Example:

"a649e4d9-435c-43fb-83ba-847b4876f27a"

Response

Success

data

object

required

Show child attributes

data.id

object

required

Show child attributes

data.id.workspace_id

string<uuid>

required

The ID of the workspace the thread belongs to.

Example:

"14beef7a-99f7-4534-a87e-70b564330a4c"

data.id.thread_id

string<uuid>

required

The ID of the thread.

Example:

"a649e4d9-435c-43fb-83ba-847b4876f27a"

data.comments

object[]

required

An array of comments in the thread, sorted by created_at.

Minimum array length: 1

Show child attributes

data.comments.id

object

required

Show child attributes

data.comments.id.workspace_id

string<uuid>

required

The ID of the workspace the comment belongs to.

Example:

"14beef7a-99f7-4534-a87e-70b564330a4c"

data.comments.id.comment_id

string<uuid>

required

The ID of the comment.

Example:

"aa1dc1d9-93ac-4c6c-987e-16b6eea9aab2"

data.comments.thread_id

string<uuid>

required

The ID of the thread the comment belongs to.

Example:

"aa1dc1d9-93ac-4c6c-987e-16b6eea9aab2"

data.comments.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.

Example:

"Let's go ahead and close this deal, [email protected]."

data.comments.entry

object

required

The entry the comment belongs to, null for comments on records.

Show child attributes

data.comments.entry.entry_id

string<uuid>

required

The ID of the entry the comment belongs to.

Example:

"2e6e29ea-c4e0-4f44-842d-78a891f8c156"

data.comments.entry.list_id

string<uuid>

required

The ID of the list the entry belongs to.

Example:

"33ebdbe9-e529-47c9-b894-0ba25e9c15c0"

data.comments.record

object

required

The record the comment belongs to.

Show child attributes

data.comments.record.record_id

string<uuid>

required

The ID of the record the comment belongs to.

Example:

"bf071e1f-6035-429d-b874-d83ea64ea13b"

data.comments.record.object_id

string<uuid>

required

The ID of the object the record belongs to.

Example:

"97052eb9-e65e-443f-a297-f2d9a4a7f795"

data.comments.resolved_at

string | null

required

Whether the comment is resolved.

Example:

"2023-01-01T15:00:00.000000000Z"

data.comments.resolved_by

object

required

The actor that resolved this comment.

Show child attributes

data.comments.resolved_by.id

string | null

An ID to identify the actor.

data.comments.resolved_by.type

enum<string> | null

The type of actor. Read more information on actor types here.

Available options:

api-token,

workspace-member,

system,

app

Example:

{
  "type": "workspace-member",
  "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}

data.comments.created_at

string

required

When the note was created.

Example:

"2023-01-01T15:00:00.000000000Z"

data.comments.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.

Show child attributes

data.comments.author.id

string | null

An ID to identify the actor.

data.comments.author.type

enum<string> | null

The type of actor. Read more information on actor types here.

Available options:

api-token,

workspace-member,

system,

app

Example:

{
  "type": "workspace-member",
  "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}

data.created_at

string

required

When the thread was created.

Example:

"2023-01-01T15:00:00.000000000Z"

List threads Create a comment

⌘I

Introduction

Guides

Tutorials

Endpoint reference

Webhook reference

Get a thread

Authorizations

Path Parameters

Response