1. Comments
    2. /Thread

    Thread

    Threads are groups of comments on a Record or Entry.

    List Threads

    List Threads of Comments on a Record or List Entry.

    Scopes

    • comment:readrequired
    • list_entry:readoptional
    • record_permission:readoptional
    • list_configuration:readoptional
    • object_configuration:readoptional

    Query params

    liststring

    Use this parameter to filter to Threads on a specific Entry. Must be passed with entry_id. Accepts either a slug or an ID.

    limitinteger

    The maximum number of results to return. The default is 10 and the maximum is 50. See the full guide to pagination here.

    objectstring

    Use this parameter to filter to Threads on a specific Record. Must be passed with record_id. Accepts either a slug or an ID.

    offsetinteger

    The number of results to skip over before returning. The default is 0. See the full guide to pagination here.

    entry_idstring

    Use this parameter to filter to Threads on a specific Entry. Must be passed with list.

    Format: UUID

    record_idstring

    Use this parameter to filter to Threads on a specific Record. Must be passed with object.

    Format: UUID

    Response

    Status code

    Description

    Request

    GET
    /v2/threads
    curl https://api.attio.com/v2/threads?list=33ebdbe9-e529-47c9-b894-0ba25e9c15c0&limit=10&object=people&offset=5&entry_id=2e6e29ea-c4e0-4f44-842d-78a891f8c156&record_id=bf071e1f-6035-429d-b874-d83ea64ea13b \
      -H "Authorization: Bearer <token>"

    Response

    200 - Success

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

    Get a Thread

    Get all comments in a Thread.

    Scopes

    • comment:readrequired
    • list_entry:readoptional
    • record_permission:readoptional
    • list_configuration:readoptional
    • object_configuration:readoptional

    Path params

    thread_idstring

    REQUIRED

    A UUID which identifies the Thread.

    Format: UUID

    Response

    Status code

    Description

    Request

    GET
    /v2/threads/:thread_id
    curl https://api.attio.com/v2/threads/a649e4d9-435c-43fb-83ba-847b4876f27a \
      -H "Authorization: Bearer <token>"

    Response

    200 - Success

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