When someone in your org asks their AI assistant to add a Task Group, tick off a Checklist Item or share a Checklist Group in Collaboration View, the assistant uses the tools in this article. Each one runs with the user's own Salesforce permissions, so the assistant can only change what the user could change in TaskRay themselves.
Task Groups
| What the assistant can do | A user might ask | Waits for approval |
|---|---|---|
| Create a Task Group | "Add a Discovery task group to the Acme Onboarding project." | No |
| Read a Task Group | "Show me the Discovery task group." | No |
| Update a Task Group | "Mark the Discovery task group complete." | No |
| Delete a Task Group and the Tasks in it | "Delete the Discovery task group." | Yes |
| List Task Groups | "What task groups are in the Acme Onboarding project?" | No |
Checklist Groups
| What the assistant can do | A user might ask | Waits for approval |
|---|---|---|
| Create a Checklist Group | "Add a Kickoff Prep checklist to the Kickoff call task." | No |
| Read a Checklist Group | "Show me the Kickoff Prep checklist." | No |
| Update a Checklist Group | "Show the Kickoff Prep checklist in Collaboration View." | No |
| Delete a Checklist Group, keeping its Checklist Items | "Delete the Kickoff Prep checklist group." | Yes |
| List Checklist Groups | "Which checklists on the Kickoff call task are shared in Collaboration View?" | No |
Checklist Items
| What the assistant can do | A user might ask | Waits for approval |
|---|---|---|
| Create a Checklist Item | "Add 'Send the agenda' to the Kickoff call task and assign it to Sam." | No |
| Read a Checklist Item | "Who's the 'Send the agenda' item assigned to?" | No |
| Update a Checklist Item | "Mark 'Send the agenda' as done." | No |
| Delete a Checklist Item | "Delete the duplicate 'Send the agenda' item." | Yes |
| List Checklist Items | "What's still open on the Kickoff call checklist?" | No |
Good to Know
- Deletes wait for the user to approve them, as described in TaskRay MCP Tool Reference: Approvals for Delete, Bulk and Elevated Tools. Deleted records go to the Salesforce Recycle Bin for 15 days. For a Task Group, archiving is the reversible alternative.
- Assigning a Checklist Item to someone who isn't on the Project team adds them to it.
- Archived work stays out of lists unless the user asks for it. Records in templates are handled by the tools in TaskRay MCP Tool Reference: Template Tools.
Frequently Asked Questions
Q. Someone new appeared on a Project team after a user's assistant added Checklist Items. Why?
Great question! Assigning a Checklist Item to a user or queue adds them to the Project team.
Where to Go Next
- TaskRay MCP Tool Reference: Bulk Create and Bulk Update: changing many Task Groups, Checklist Groups or Checklist Items in one request.
- TaskRay MCP Tool Reference: Tasks, Milestones and Dependencies: the Tasks these records belong to.
Have a question this reference doesn't answer? Not to worry, our Support Team is ready to help! Contact TaskRay Support with what the user asked their assistant to do, the exact error text, and whether the org is production or sandbox.