The write tools let an AI agent create or modify projects, tasks, comments, and template-driven structures. They are intended for interactive assistants or orchestrated workflows that need to do more than just answer questions.
These are the tools to use when an assistant should take action rather than only observe. They are useful for guided intake experiences, chat-style assistants that help staff maintain project data, or orchestrated automations that need to update projects and tasks as part of a larger flow.
AddOrUpdateProject creates or edits a project, including parent, due date, requester, category, assignees, blocking projects, and custom attribute values.AddOrUpdateTask creates or edits a task, including assignee, start date, due date, ordering, and blocking tasks.AddOrUpdateProjectComment writes markdown comments on a project. When adding a comment, the current person becomes the author and is automatically added as a watcher on the project.ApplyProjectTemplate applies a compatible template to an existing project. It preserves existing content and adds the template's tasks and sub-projects.- Delete operations exist for tasks and project comments, but they are distinct destructive tools rather than flags on the update methods.
A safe write flow usually starts with a read step. For example, an agent might first load a project's available attributes or confirm the current task state, then send a focused update with only the changes that are intended. That pattern helps the tools stay precise and predictable.
Note
Tasks do not expose custom attribute writes through the AI tools. Custom attribute discovery and updates are project-focused, so a common pattern is to call GetProjectAvailableAttributes before setting project attribute values.