---
title: "Get the next available posting time slot"
method: GET
path: "/posting-schedules/next-slot"
tags: ["Posting Schedules"]
---

# Get the next available posting time slot

`GET /posting-schedules/next-slot`

## Request

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

## Query parameters

- `workspace_id` string: Workspace ID

## Response `200`

OK

- NextAvailableSlotOutputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `message` string, required: Message about the result
  - `slot` PostingScheduleResponse
    - `$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
  - `slot_time` string, required: The suggested time in ISO 8601 format

## Other responses

- `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)