---
title: "Generate a suggested posting schedule"
method: POST
path: "/posting-schedules/suggest"
tags: ["Posting Schedules"]
---

# Generate a suggested posting schedule

`POST /posting-schedules/suggest`

## Request

- Base URL: `https://app.openpo.st/api/v1`
- URL: `https://app.openpo.st/api/v1/posting-schedules/suggest`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `openpost_session`

## Request body

- SuggestScheduleInputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `posts_per_day` integer, required: Number of posts per day (1-10)
  - `workspace_id` string, required: Workspace ID

## Response `200`

OK

- SuggestScheduleOutputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `message` string, required: Message about the result
  - `schedules` PostingScheduleResponse[], nullable, required: Created schedule slots
    - `$schema` string, uri: A URL to the JSON Schema for this object.
    - `created_at` string, required: Creation time (ISO 8601)
    - `day_of_week` integer, required: Workspace-local day of week (0=Sunday, 6=Saturday)
    - `id` string, required: Schedule ID
    - `is_active` boolean, required: Whether this slot is active
    - `label` string: Display label (e.g., Morning, Lunch)
    - `local_day_of_week` integer, required: Day of week in workspace local time (0=Sunday, 6=Saturday)
    - `local_hour` integer, required: Hour in workspace local time (0-23)
    - `local_minute` integer, required: Minute in workspace local time (0-59)
    - `utc_hour` integer, required: Legacy field name for the workspace-local hour (0-23)
    - `utc_minute` integer, required: Legacy field name for the workspace-local minute (0-59)
    - `workspace_id` string, required: Workspace ID

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

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