---
title: "Where run_at \"next_slot\" would put a post now (nothing is queued)"
method: GET
path: "/api/schedule/next-slot"
---

# Where run_at "next_slot" would put a post now (nothing is queued)

`GET /api/schedule/next-slot`

## Request

- Base URL: `https://postwire.io`
- URL: `https://postwire.io/api/schedule/next-slot`
- Auth: HTTP bearer

A post goes to the earliest slot that every one of its networks has and that none of them already uses for another waiting (queued, held or publishing) post of the same brand. When its networks share no slot, it goes to the earliest slot of any of them that is free for all. Slots less than 2 minutes away are skipped; the search looks 28 days ahead.

## Query parameters

- `platforms` string, required
- `brand_id` string, uuid
- `timezone` string

## Response `200`

{ brand_id, platforms, run_at, timezone, local, shared }

## Other responses

- `400`: platforms missing or unknown, bad_timezone
- `409`: no_free_slot

---

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