---
title: "Create Schedule"
method: POST
path: "/api/workspace/analytics/cards/{card_id}/schedules"
tags: ["workspace-analytics", "workspace-analytics"]
---

# Create Schedule

`POST /api/workspace/analytics/cards/{card_id}/schedules`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/workspace/analytics/cards/{card_id}/schedules`
- Auth: none declared

Create a new schedule for a card to run on a recurrence.

Validates card and thread are in the workspace, computes next_run_at,
and inserts the schedule.

## Path parameters

- `card_id` integer, required

## Request body

- ScheduleCreate
  - `thread_id` integer, required
  - `frequency` 'daily' | 'weekly' | 'monthly', required
  - `day_of_week` integer, nullable
  - `day_of_month` integer, nullable
  - `time_of_day` string, required
  - `timezone` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/77bef09a9209?raw)