---
title: "Test Schedule Def Route"
method: POST
path: "/api/schedule_defs/test"
---

# Test Schedule Def Route

`POST /api/schedule_defs/test`

## Request

- Base URL: `https://app.getdot.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://app.getdot.ai/api/schedule_defs/test`
- Auth: one of:
  - API key in header `X-API-KEY`
  - API key in cookie `Authorization`
  - OAuth 2 (password, token URL `/api/auth/token`)

Send one delivery now using the settings on screen, saved or not.

Authorized exactly like create — app view access, and Run As still admin-only — but
it writes nothing: no YAML in the model repo (an app publish's ``git add .`` would
adopt a throwaway one as a real schedule), no job, no trust pin, no ledger row.

## Request body

- ScheduleDefRequest
  - `app_id` string, required
  - `schedule_id` string, nullable
  - `every` string, required
  - `at` string, nullable
  - `on` unknown
  - `timezone` string
  - `work` string
  - `prompt` string, nullable
  - `result_gate` string, nullable
  - `cards` string[], nullable
  - `params` object, nullable
  - `trigger` object, nullable
  - `owner_id` string, nullable
  - `deliveries` DeliveryModel[]
    - `channel` string, required
    - `to` string[], required
    - `attach_pdf` boolean
    - `pdf_layout` 'pages' | 'one_page'
    - `embed_app` boolean
  - `paused` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/getdot/apis/dot-api-2.md) · [All operations](https://skmtc.dev/getdot/apis/dot-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/getdot/apis/dot-api-2/revisions/d26fe7163a7f?raw)