Find the next free slot
GET /public/v1/find-slot/{id}Returns the next free time from this channel’s configured time slots. A slot counts as taken when any post in your organization already sits at that minute, on any channel and in any state, drafts included.
Use it when you want to queue a post without picking a time yourself: call this, then
pass the result straight into create a post as date.
Doing this in the app? See the calendar. The CLI has no command for it, and the MCP server has no tool for it.
Path parameters
Section titled “Path parameters”| Parameter | Required | Description |
|---|---|---|
id |
Yes | The integration id from list channels. |
Request
Section titled “Request”curl -H "Authorization: your-api-key" \ https://dash.sharek.app/api/public/v1/find-slot/channel-idResponse
Section titled “Response”{ "date": "2026-09-01T10:00:00" }The time is in UTC, written as YYYY-MM-DDTHH:mm:00 with no Z and no milliseconds.
Create a post reads it as UTC, so pass it on as it is.
- The answer reflects the moment you asked. Two calls in a row can return the same slot, because nothing is reserved until you actually create the post. If you are queueing several posts in a loop, create each one before asking for the next slot.
- Time slots are configured per channel in the app, under Edit Time Slots in the channel menu. A channel with no slots configured, or a disabled one, falls back to 02:00, 06:40 and 11:40 UTC.
- The search starts today and looks up to 365 days ahead. If every slot in that window is taken, it stops and still answers, with a time just past the window.