---
title: "Get routine"
method: GET
path: "/routines/{jobId}"
tags: ["routines"]
---

# Get routine

`GET /routines/{jobId}`

## Request

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

Get a routine.

## Path parameters

- `jobId` string, required

## Response `200`

Successful response

- object: A routine (cron trigger).
  - `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

## 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)