Validate a post

Authorizations

Authorization

string

header

required

An API key beginning with nylon_live_.

Body

application/json

profile_ids

string[]

required

The connected profiles to publish to. Every one is validated before anything sends.

Minimum array length: 1

Example:

["cly7p2q4k0001x8b3f2n9d0aa"]

text

string

default:""

The caption. On the four threading networks this may exceed one post's limit — see auto_thread.

Maximum string length: 20000

media

(string<uri> | object)[]

Maximum array length: 35

A URL, or an object when you want alt text or a video cover.

Example:

"https://cdn.example.com/launch.jpg"

link

A link to attach, on the networks that render one.

post_type

enum<string>

default:post

Available options:

post,

reel,

story

title

string | null

Required by YouTube; used by Pinterest and TikTok photo posts.

Maximum string length: 300

thread

string[] | null

Explicit thread parts. When set they are published verbatim rather than derived from text — someone who wrote the breaks gets the breaks they wrote.

Maximum array length: 50

auto_thread

boolean

default:true

Split an over-long caption into a thread rather than rejecting it. Only meaningful on X, Threads, Bluesky and Mastodon.

scheduled_at

string<date-time> | null

When to publish. A time in the past is treated as now rather than refused, and so is a time less than a minute out — "in forty seconds" means now. Anything further out is held by a durable run that wakes at that time. The response says which happened: status: "scheduled" with the time, or an already-published post.

publish_now

boolean

Publish immediately, ignoring scheduled_at.

idempotency_key

string | null

Replaying a request with a key that was already used returns the original post untouched, with Idempotent-Replay: true.

Required string length: 8 - 255

networks

object

Per-network overrides, keyed by network. An unknown key is rejected by name.

Hide child attributes

networks.{key}

object

Per-network overrides. The content keys below replace the base values for that network only; every other key is passed through to the publisher, because the option set differs per network. GET /v1/networks lists the options each one reads.

Hide child attributes

networks.{key}.text

string | null

networks.{key}.title

string | null

networks.{key}.media

(string<uri> | object)[] | null

A URL, or an object when you want alt text or a video cover.

Example:

"https://cdn.example.com/launch.jpg"

networks.{key}.thread

string[] | null

networks.{key}.post_type

enum<string> | null

Available options:

post,

reel,

story,

null

Example:

{
  "board_id": "881573081235",
  "title": "Launch day"
}

Response

The verdict. valid is false when any addressed network rejects the post; the response is still 200, because the request itself was well formed.

data

object

required

Hide child attributes

data.valid

boolean

required

True only when every addressed network accepts the post.

data.targets

object[]

required

Hide child attributes

data.targets.profile_id

string

required

data.targets.network

enum<string>

required

A network Nylon publishes to.

Available options:

facebook,

instagram,

x,

linkedin,

pinterest,

bluesky,

threads,

tiktok,

youtube,

google_business,

mastodon,

discord

Example:

"instagram"

data.targets.profile_name

string

required

data.targets.valid

boolean

required

data.targets.errors

object[]

required

Hide child attributes

data.targets.errors.code

string

data.targets.errors.message

string

data.targets.thread_parts

string[] | null

How the caption will be split on this network. Null when the content is invalid — a caption the splitter could not fit is already reported as an error.

data.errors

object[]

required

Every issue across every network, flattened.

Hide child attributes

data.errors.message

string

required

Example:

"Instagram requires at least 1 media item — text-only posts are not supported."

data.errors.field

string

The request field the problem is about.

Example:

"profile_ids"

data.errors.network

string

The network the problem is about.

Example:

"instagram"

data.errors.code

string

Machine-readable identifier for this problem. On a per-network detail this is a publishing code: invalid_request, unsupported, media_error, reauthentication_required, rejected_by_network, network_error, timeout, profile_unavailable or internal_error.

Example:

"invalid_request"

Overview

Endpoints

Authorizations

Body

Response