Get a thread
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.
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, 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"
}
}
],
"created_at": "2023-01-01T15:00:00.000000000Z"
}
}Authorizations
This API uses OAuth 2.0 with the authorization code grant flow.
Path Parameters
A UUID which identifies the thread.
"a649e4d9-435c-43fb-83ba-847b4876f27a"
Response
Success
An array of comments in the thread, sorted by created_at.
The ID of the thread the comment belongs to.
"aa1dc1d9-93ac-4c6c-987e-16b6eea9aab2"
A plaintext representation of the content of the comment. References to workspace members are cast into email addresses, all other stylistic elements are removed.
"Let's go ahead and close this deal, alice@attio.com."
The entry the comment belongs to, null for comments on records.
The record the comment belongs to.
Whether the comment is resolved.
"2023-01-01T15:00:00.000000000Z"
The actor that resolved this comment.
An ID to identify the actor.
The type of actor. Read more information on actor types here.
api-token, workspace-member, system, app {
"type": "workspace-member",
"id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}
When the note was created.
"2023-01-01T15:00:00.000000000Z"
Who wrote this comment. Note that the API provides the ability for API tokens to write comments on behalf of other actors.
An ID to identify the actor.
The type of actor. Read more information on actor types here.
api-token, workspace-member, system, app {
"type": "workspace-member",
"id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}
When the thread was created.
"2023-01-01T15:00:00.000000000Z"
Was this page helpful?
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, 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"
}
}
],
"created_at": "2023-01-01T15:00:00.000000000Z"
}
}