Routines

Routines

Routines are Paperclip's recurring execution layer. Use them when you want an agent to run on a schedule, respond to a webhook, or be kicked off manually through the API.

A routine does not do the work itself. It creates a run, and that run usually creates or links to an execution issue for the assigned agent.

---

What A Routine Controls

A routine ties together:

the agent that owns the work the project, goal, and optional parent issue context the title and description template for the execution issue the trigger or triggers that start runs the concurrency policy when another run is already active the catch-up policy for missed schedule ticks

Routine status values are:

| Status | Meaning | |---|---| | active | The routine can fire and create runs. | | paused | The routine is stored but does not fire automatically. | | archived | The routine is retired. Archived routines do not fire. |

You cannot have an active routine without an assignee agent. If you try to create or enable one without an assignee, the API normalizes it to paused or rejects the activation.