Validate post
Runs preflight checks against the same payload shape as publish. Use it before automation or AI-driven posting so content problems are caught before quota is consumed.
Authorization
AuthorizationBearer <token>In header
Workspace API key.
Request Body
platform_postsarray
Recommended unified request shape for per-account content.
scheduled_at?string
Optional scheduled publish time in ISO-8601 format.
platform_posts[]
platform_posts[].account_idstring
Connected social account to validate against.
platform_posts[].caption?string
Caption or post text to validate.
platform_posts[].media_urls?string[]
Public asset URLs to validate for that destination.
platform_posts[].media_ids?string[]
Media library IDs to validate for that destination. Poll GET/v1/media/:media_id until uploaded before publishing.
platform_posts[].thread_position?integer
1-indexed thread slot for X and Bluesky thread validation.
platform_posts[].first_comment?string
Optional first reply/comment validation for supported platforms.
platform_posts[].platform_options?object
Platform-specific options such as Instagram media type or Pinterest board selection.
Response Body
200
validboolean
Whether the payload can be published without fatal validation errors.
errorsarray
Blocking validation issues.
errors[].platform_post_indexinteger
0-based input index that produced the issue.
errors[].account_idstring
Account ID associated with the issue when known.
errors[].platformstring
Resolved platform associated with the issue when known.
errors[].fieldstring
Request field that failed validation.
errors[].codestring
Machine-readable validation code.
errors[].messagestring
Human-readable validation message.
errors[].actual?any
Structured details for issue-specific recovery steps, when available.
errors[].severitystring
Issue severity. Blocking items are returned as "error".
warningsarray
Non-blocking validation issues.
401
error.codestring
Usually "UNAUTHORIZED", "VALIDATION_ERROR", or "INTERNAL_ERROR".
error.normalized_codestring
Lowercase alias such as "unauthorized", "validation_error", or "internal_error".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
422
error.codestring
Usually "UNAUTHORIZED", "VALIDATION_ERROR", or "INTERNAL_ERROR".
error.normalized_codestring
Lowercase alias such as "unauthorized", "validation_error", or "internal_error".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
500
error.codestring
Usually "UNAUTHORIZED", "VALIDATION_ERROR", or "INTERNAL_ERROR".
error.normalized_codestring
Lowercase alias such as "unauthorized", "validation_error", or "internal_error".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.