Validate a post (dry-run without publishing)

Tools

Authorization

Bearer

AuthorizationBearer <token>

API key (rlay_live_* or rlay_test_*)

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

content?string

Post text. Optional if target_options provide per-target content.

targets*array<>

Account IDs, platform names, or workspace IDs to publish to

Items1 <= items

scheduled_at*string

Publish intent. Use "now" to publish immediately, "draft" to save as draft, "auto" to auto-schedule to the best available slot, or an ISO 8601 timestamp to schedule (max 30 days ahead).

media?array<>

Media attachments

target_options?

Per-target customizations keyed by target value (account ID or platform name). Supports platform-specific features such as Twitter polls (poll.options, poll.duration_minutes), threads, reply_to, and reply_settings.

timezone?string

IANA timezone for scheduling

Default"UTC"

workspace_id?string

Workspace ID to scope this post to

recycling?

Recycling configuration for evergreen content (Pro plan only)

shorten_urls?boolean

Shorten URLs in post content. Only relevant when short link mode is 'ask'. Ignored when mode is 'always' or 'never'. (Pro plan only)

cross_post_actions?array<>

Cross-post actions to execute after publishing (e.g., repost from another account, comment from another account)

template_id?string

Content template ID. When provided, the template content is used as the base for the post. Explicit 'content' field takes precedence.

idea_id?string

Create post from an idea. Pre-fills content from the idea. Explicit 'content' field takes precedence.

template_variables?

Variables to interpolate in the template (e.g., { "promo_code": "SUMMER25" }). Built-in variables: {{date}}, {{account_name}}.

skip_signature?boolean

When true, the default signature is not auto-appended even if one is configured.

Response Body

`application/json`

curl -X POST "https://example.com/v1/tools/validate/post" \  -H "Content-Type: application/json" \  -d '{    "targets": [      "string"    ],    "scheduled_at": "now"  }'

{  "valid": true,  "errors": [    {      "target": "string",      "code": "string",      "message": "string"    }  ],  "warnings": [    {      "target": "string",      "code": "string",      "message": "string"    }  ]}

{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}

Found something wrong? Help us improve this page.

Report an issue Edit this page on GitHub

Validate a media URL for platform compatibility POST

Check character counts against platform limits POST

Validate a post (dry-run without publishing)

Authorization

Request Body

Response Body

200application/json

401application/json

`application/json`

`application/json`