How-to guides

Pause or archive an agent

Set an agent's Status to Paused or Archived to stop the work it does on its own. Its scheduled and webhook routines stop firing, and Run now still works.

Every agent has a Status: Active, Paused or Archived. Paused and Archived both stop the work the agent does on its own. Nothing you start yourself is blocked.

Changing the status

  1. Open the agent and press Manage.
  2. Under Status, pick Paused or Archived.
  3. Press Save.

The hint under the field reads "Archive to retire an agent without deleting its work." The agent's tasks, runs and reports stay where they are. To bring the agent back, set its Status to Active again.

What stops

While an agent is Paused or Archived:

  • Its scheduled routines do not fire. No task is created for those occurrences, so they are not waiting as to-dos when you set the agent back to Active.
  • Its webhook routines do not fire. The service that calls the webhook gets an answer saying the agent is paused or archived, and it can retry the delivery once the agent is Active.
  • Tasks already on its to-do list stay there. The agent does not pick them up by itself until it is Active again.

What still works

Run now still works, on a routine and on a task. Pressing it is your own decision, so the status does not block it.

Status or "Run tasks automatically"?

The Manage dialog also has a "Run tasks automatically" setting. Turning it off stops the agent working its to-do list on its own, but its routines still come due: each skipped run is filed as a to-do, and the Routines panel shows "Won't run: autonomy is off, or Run tasks automatically is off for this agent".

Setting Status to Paused or Archived goes further. Scheduled and webhook routines create nothing at all.

How the Routines panel shows it

Open the agent and press Routines. While the agent is Paused, a note at the top reads "This agent is Paused, so its scheduled and webhook routines won't run. Run now still works." (it says Archived for an archived agent). The Change status button next to it opens Manage, where you can set the Status back to Active.

Each scheduled or webhook routine that is switched on also shows "Won't run: this agent is Paused" (or Archived), and its next run time is hidden because that run will not happen. Manual routines and routines you have switched off are not marked. Once you set the agent back to Active, the note and the markers go away.

Related reading