Sign in
Threads

Get a thread and its comments

Get a thread and page through its comments, oldest first, starting with the comment that opened it.

Comments are paginated: at most 250 are returned per request. Keep paginating for as long as a next_cursor is returned.

Supply created_after to return only the comments created after a timestamp, which is useful when polling a thread for new replies. The comment that opened the thread is returned only when it also satisfies the filter.

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.

get/v2/threads/{thread_id}

Path parameters

thread_idstring uuid required

A UUID which identifies the thread.

Example:a649e4d9-435c-43fb-83ba-847b4876f27a

Query parameters

limitinteger

The maximum number of comments to return. Defaults to 250, which is also the maximum.

Example:250
cursorstring

A cursor for pagination. Use the next_cursor from the previous response to get the next page of comments.

Example:eyJkZXNjcmlwdGlvbiI6ICJ0aGlzIGlzIGEgY3Vyc29yIn0=.eM56CGbqZ6G1NHiJchTIkH4vKDr
created_afterstring nullable

Only return comments created after this timestamp.

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

Response

Success

Example response

{
  "data": {
    "id": {
      "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
      "thread_id": "a649e4d9-435c-43fb-83ba-847b4876f27a"
    },
    "created_at": "2023-01-01T15:00:00.000000000Z",
    "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, alice@attio.com.",
        "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"
        }
      }
    ]
  }
}

Changes