List threads

List threads of comments on a record or list entry.

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

List threads

cURL

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

200

{
  "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, [e-mail].",
          "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.

Query Parameters

record_id · string<uuid>

Use this parameter to filter to threads on a specific record. Must be passed with object.

Example:

"891dcbfc-9141-415d-9b2a-2238a6cc012d"

object · string

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

Example:

"people"

entry_id · string<uuid>

Use this parameter to filter to threads on a specific entry. Must be passed with list.

Example:

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

list · string

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

Example:

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

limit · integer

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

Example:

10

offset · integer

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

Example:

5

Response

200 - application/json

Success

Success

data · object[] · required

Show child attributes