Skip to main content
Developers

Post preflight (dry run)

Check a post against platform rules without creating anything.

POST /api/posts/validate

Checks a post exactly as create or update would, writes nothing, and never returns a 4xx for platform problems. Same auth and permissions as creating a post, and not counted against the hourly post limit.

bash
curl -s -X POST "https://plotpostapi.kriva.studio/api/posts/validate" \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"application_id":"WORKSPACE_ID","body":"...","account_ids":["ACCOUNT_ID"],"media_ids":["MEDIA_ID"],"action":"schedule","scheduled_for":"2026-10-15T04:00:00Z"}'

Response

FieldMeaning
okTrue when there are no blockers.
blockers[]Problems that would make the platform reject the post: {platform, account_id, account, code, message, fix?}.
warnings[]Things that work but are worth knowing, for example an image converted to JPEG.
missing[]Options still worth asking the user: {platform, field, question, importance}.
per_platform[]Per account: ok, issues, char_count, char_limit, thread preview for X.
requires_approvalTrue when a non-publisher’s schedule or publish would go to approval.

For draft, platform-rule problems come back as warnings because drafts are not checked against platform limits; for every other action they are blockers.

v0.1.2

Post preflight (dry run) | Documentation | Sociquza