Scheduling

Schedule a post

Validates, persists, and enqueues a post for publishing via the BullMQ worker. Runs (in order): monthly plan-quota check → connected-account ownership check → server-side post-signature append → safety-gateway check (account health, daily caps, min gap, hashtag rules, duplicate detection) → idempotent insert (same account+platform+scheduledAt hashes to the same key — a repeat call returns 409, not a duplicate post) → BullMQ enqueue. Rate limit: 30 requests/minute.

post/schedule

Request

  • Base URL: https://api.misar.io/post
  • URL: https://api.misar.io/post/schedule
  • Auth: API key in header Authorization

Request body

connectedAccountIdstring uuid required
platform'twitter' | 'linkedin' | 'instagram' | 'threads' | 'tiktok' | 'bluesky' | 'mastodon' | 'youtube' | 'reddit' | 'pinterest' | 'dribbble' | 'slack' | 'discord' | 'facebook' | 'telegram' | 'devto' | 'farcaster' | 'gmb' | 'hashnode' | 'lemmy' | 'listmonk' | 'medium' | 'mewe' | 'moltbook' | 'nostr' | 'skool' | 'tumblr' | 'twitch' | 'vk' | 'linkedin_page' | 'instagram_standalone' | 'tiktok_business' | 'whop' | 'wordpress' | 'kick' required
contentTextstring required
mediaUrlsstring[]
firstCommentstring

Optional first-comment text (used by platforms that support it).

variantIdstring uuid

Marks the source draft/generated variant as scheduled once this post is created.

platformMetaobject

Per-post provider-specific fields with no dedicated column (e.g. Reddit subreddit, Pinterest board, YouTube title). Passed through verbatim; each publishing adapter reads the keys it needs.

Response

Scheduled and enqueued.

Changes

No recorded changes to this operation across all 1 revision of this API.