---
title: "How often a scheduled chat runs, and how it could run less often"
method: GET
path: "/api/schedules/followups/{schedule_key}/cadence"
tags: ["v1", "schedules"]
---

# How often a scheduled chat runs, and how it could run less often

`GET /api/schedules/followups/{schedule_key}/cadence`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

## Path parameters

- `schedule_key` string, required: The routine's id, or the follow-up's schedule id

## Response `200`

Successful Response

- ScheduledChatCadence
  - `schedule_key` string, required
  - `title` string, required
  - `current` string, nullable, required
  - `timezone` string, required
  - `options` CadenceOption[], required
    - `cron` string, required
    - `label` string, required

## Other responses

- `401`: Authentication required
- `422`: Validation Error

## Changes

- **2026-10-20** `0f5b179ba34c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/schedules/followups/:schedule_key/cadence/get.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) - [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) - [OpenAPI document](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/revisions/c508818c16ad?raw)