643 matches
49 actions
Attio
49 actions
CRM/Attio
Creates a new comment related to an existing thread, record or entry.
To create comments on records, you will need the object_configuration:read and record_permission:read scopes.
To create comments on list entries, you will need the list_configuration:read and list_entry:read scopes.
Required scopes: comment:read-write.
{
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"type": "object"
}
}
}{
"type": "object",
"description": "Success",
"required": [
"data"
],
"properties": {
"data": {
"type": "object",
"required": [
"author",
"content_plaintext",
"created_at",
"entry",
"id",
"record",
"resolved_at",
"resolved_by",
"thread_id"
],
"properties": {
"author": {
"type": "object",
"description": "Who wrote this comment. Note that the API provides the ability for API tokens to write comments on behalf of other actors.",
"properties": {
"id": {
"type": "string",
"description": "An ID to identify the actor."
},
"type": {
"type": "string",
"description": "The type of actor. [Read more information on actor types here](/docs/actors).",
"enum": [
"api-token",
"workspace-member",
"system",
"app"
]
}
}
},
"content_plaintext": {
"type": "string",
"description": "A plaintext representation of the content of the comment. References to workspace members are cast into email addresses, all other stylistic elements are removed."
},
"created_at": {
"type": "string",
"description": "When the note was created."
},
"entry": {
"type": [
"object",
"null"
],
"description": "The entry the comment belongs to, `null` for comments on records.",
"required": [
"entry_id",
"list_id"
],
"properties": {
"entry_id": {
"type": "string",
"format": "uuid",
"description": "The ID of the entry the comment belongs to."
},
"list_id": {
"type": "string",
"format": "uuid",
"description": "The ID of the list the entry belongs to."
}
}
},
"id": {
"type": "object",
"required": [
"comment_id",
"workspace_id"
],
"properties": {
"comment_id": {
"type": "string",
"format": "uuid",
"description": "The ID of the comment."
},
"workspace_id": {
"type": "string",
"format": "uuid",
"description": "The ID of the workspace the comment belongs to."
}
}
},
"record": {
"type": "object",
"description": "The record the comment belongs to.",
"required": [
"object_id",
"record_id"
],
"properties": {
"object_id": {
"type": "string",
"format": "uuid",
"description": "The ID of the object the record belongs to."
},
"record_id": {
"type": "string",
"format": "uuid",
"description": "The ID of the record the comment belongs to."
}
}
},
"resolved_at": {
"type": [
"string",
"null"
],
"description": "Whether the comment is resolved."
},
"resolved_by": {
"type": "object",
"description": "The actor that resolved this comment.",
"properties": {
"id": {
"type": "string",
"description": "An ID to identify the actor."
},
"type": {
"type": "string",
"description": "The type of actor. [Read more information on actor types here](/docs/actors).",
"enum": [
"api-token",
"workspace-member",
"system",
"app"
]
}
}
},
"thread_id": {
"type": "string",
"format": "uuid",
"description": "The ID of the thread the comment belongs to."
}
}
}
}
}