When someone in your org asks their AI assistant to add a Task, push back a date or link two Tasks, 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.
Tasks
| What the assistant can do | A user might ask | Waits for approval |
|---|---|---|
| Create a Task | "Add a Kickoff call task to the Acme Onboarding project for Priya." | No |
| Read a Task | "Show me the Kickoff call task." | No |
| Update a Task | "Move Kickoff call to In Progress." | No |
| Delete a Task, with its Checklist Groups, Checklist Items, Time Entries and Dependencies | "Delete the duplicate Kickoff call task." | Yes |
| List Tasks | "What's overdue on the Acme Onboarding project?" | No |
| List a Task's Kanban columns | "Which columns can the Kickoff call task go in?" | No |
Milestones
| What the assistant can do | A user might ask | Waits for approval |
|---|---|---|
| Read a milestone | "When is Go-Live due?" | No |
Dependencies
| What the assistant can do | A user might ask | Waits for approval |
|---|---|---|
| Create a Dependency | "Make Build start after Design finishes." | No |
| Read a Dependency | "What kind of dependency links Design and Build?" | No |
| Update a Dependency | "Change the gap between Design and Build to five days." | No |
| Delete a Dependency | "Remove the dependency between Design and Build." | Yes |
| List Dependencies | "What's Build waiting on?" | 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, archiving is the reversible alternative.
- Assigning a Task to someone who isn't on the Project team adds them to it.
- If your org uses TaskRay's multiple-dependencies mode, adding or changing a Dependency reschedules the successor Task. In any other mode, no dates change.
- 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. A user's assistant said it deleted a Task, but the Task is still in TaskRay. Why?
Great question! Deletes wait for the user to approve them, so the Task is most likely still waiting for approval.
Where to Go Next
- TaskRay MCP Tool Reference: Task Groups and Checklists: the Task Groups and checklists around these Tasks.
- TaskRay MCP Tool Reference: Bulk Create and Bulk Update: changing many Tasks in one request.
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.