---
title: "List routines"
method: GET
path: "/routines"
tags: ["routines"]
---

# List routines

`GET /routines`

## Request

- Base URL: `https://www.dench.com/api/v1`
- URL: `https://www.dench.com/api/v1/routines`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

List routines.

## Query parameters

- `enabledOnly` boolean

## Response `200`

Successful response

- object
  - `jobs` object[], required
    - `id` string, required
    - `name` string, required
    - `description` string
    - `enabled` boolean, required
    - `deleteAfterRun` boolean, required
    - `createdAtMs` number, required
    - `updatedAtMs` number, required
    - `schedule` union: Schedule: recurring (`every`), cron expression, or one-shot (`at`).
      - object
        - `kind` 'every', required
        - `everyMs` integer, required: Interval in milliseconds (1s to 365d).
        - `anchorMs` integer: Optional anchor timestamp for the recurring fire.
      - object
        - `kind` 'cron', required
        - `expr` string, required: 5-field POSIX cron expression.
        - `tz` string: IANA timezone, e.g. America/New_York.
      - object
        - `kind` 'at', required
        - `at` string, required: ISO 8601 timestamp for a one-shot run.
    - `sessionTarget` string, required
    - `wakeMode` string, required
    - `payload` union, required
      - object
        - `kind` 'agentTurn', required
        - `message` string, required
      - object
        - `kind` 'systemEvent', required
        - `text` string, required
    - `state` object, required
      - `nextRunAtMs` number
      - `runningAtMs` number
      - `lastRunAtMs` number
      - `lastStatus` 'ok' | 'error' | 'skipped'
      - `lastError` string
      - `lastDurationMs` number
  - `cronStatus` object, required
    - `enabled` boolean, required
    - `nextWakeAtMs` number, nullable, required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid authentication
- `404`: Operation or resource not found
- `500`: Server error

---

[API](https://skmtc.dev/dench/apis/dench-api.md) - [All operations](https://skmtc.dev/dench/apis/dench-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dench/apis/dench-api/revisions/4a145b38f19c?raw)