---
title: "Preview a timezone-aware publishing cadence"
method: POST
path: "/v1/posts/cadence/preview"
tags: ["Posts"]
---

# Preview a timezone-aware publishing cadence

`POST /v1/posts/cadence/preview`

## Request

- Base URL: `https://api.postlake.dev`
- URL: `https://api.postlake.dev/v1/posts/cadence/preview`
- Auth: `bearerAuth` (a scheme the document does not define)

Returns deterministic UTC slots without creating, reserving, or charging for posts. Call POST /v1/posts/validate for each proposed post before creating it. Platform pacing limits remain authoritative at publish time. Ambiguous or nonexistent local times are rejected.

## Request body

- object
  - `timezone` string, required: IANA timezone, such as Europe/London.
  - `startDate` string, date, required
  - `days` integer, required
  - `localTime` string, required: Local HH:mm start time.
  - `tracks` object[], required
    - `id` string, required
    - `staggerMinutes` integer
  - `gapMinutes` integer
  - `occupiedAt` string[]: Existing UTC or offset-qualified posts to avoid. No database lookup is performed.

## Response `200`

Read-only slot preview

- object
  - `timezone` string, required
  - `slots` object[], required
    - `date` string, date, required
    - `track` string, required
    - `localTime` string, required
    - `scheduledAt` string, date-time, required

## Other responses

- `400`: Invalid date, timezone, size or unavailable local time

---

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