Skip to main content

Delete an agent that is still in use

Jaah only deletes a custom agent that nothing uses. If a project has it as its default agent, or any task picked it, the delete is refused and Jaah lists who still uses it. This page shows how to read that list, clear it, and delete the agent, or keep it and turn it off. A task that ran the agent in the past still counts, so for an agent that has done real work, disabling it is usually the right end.

Who can do this: members with permission to edit agents. Changing a project's default agent also needs permission to edit that project.

  1. In the sidebar, select Settings, then Agents under Customize, then the Custom agents tab.
  2. Select the agent's name to open its page.
  3. Select More, then Delete, and confirm Delete in the dialog. If nothing uses the agent, it is deleted and you are back on the list.
  4. If it is still in use, a warning on the page says how many tasks, and how many projects as their default agent, still use it. Under it, Jaah links the first few by name: each project is marked (default), and each task shows its title. Deleting from the ⋯ menu on the list shows the same in a dialog titled with the agent's name and is in use.
  5. For each project marked (default), select its name and change its Default agent to another one, then select Save. See Set a project's default agent.
  6. For each task, select its title. If it hasn't run yet, pick another agent in its Agent field, as in Choose the agent and account a task runs on. A task you no longer need can be deleted instead; see Archive or delete many tasks at once.
  7. Go back to the agent's page and select More, then Delete again. Repeat until the warning no longer appears.
  8. If you can't clear every use, keep the agent and turn it off. On its page, select More, then Disable; the warning also reads Disable it from More instead. In the list's dialog, select Disable. Tasks can no longer pick a disabled agent, and its past runs keep their record.