Comments
Every Comments tool, with the scope it needs, its arguments and the API operation it calls.
4 tools
Create comments
Changes dataatlas_comments_create
Create a comment on a task, project, or goal. Provide exactly one target id plus the comment body (and optional parentCommentId for a threaded reply). Requires the comments:write scope.
- Scope
comments:write- Calls
- Example prompt
- Comment on task ATL-412 that the vendor has confirmed the date.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
taskId | string | No | |
projectId | string | No | |
goalId | string | No | |
body | string | Yes | The comment text. |
parentCommentId | string | No | Reply target comment id. |
Delete comments
Destructiveatlas_comments_delete
Delete one comment by id. Only the author, or a workspace owner or administrator, may delete a comment. Requires the comments:write scope.
- Scope
comments:write- Calls
- Example prompt
- Delete my duplicate comment on the launch task.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The comment id. |
Get comments
Read onlyatlas_comments_get
Read one comment by id: its body, author, target, and timestamps. Requires the comments:read scope.
- Scope
comments:read- Calls
- Example prompt
- Open the comment I left on the launch task.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The comment id. |
List comments
Read onlyatlas_comments_list
List comments on a task, project, or goal. Provide exactly one of taskId, projectId, or goalId (plus optional cursor/limit). Cursor-paginated. Requires the comments:read scope.
- Scope
comments:read- Calls
- Example prompt
- Show me the comments on task ATL-412.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
taskId | string | No | |
projectId | string | No | |
goalId | string | No | |
cursor | string | No | |
limit | integer | No |