Skip to content

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.

Parameter Required Description
id Yes The integration id from list channels.
Terminal window
curl -H "Authorization: your-api-key" \
https://dash.sharek.app/api/public/v1/find-slot/channel-id
{ "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.