Validation and dry runs

A post that breaks a platform rule fails at publish time, often hours after it was written. The validation endpoints run the same checks up front, with no side effects: nothing is saved, no queue slot is taken and nothing is billed. They do count toward your rate limit, so debounce a live counter. Use them to show problems in your editor while the person is still typing.

#Validate a whole post

POST /v1/tools/validate/post takes the same body as POST /v1/posts. Add accountId to an X entry so the check uses that account's real text limit:

curl -X POST https://api.pozy.ai/v1/tools/validate/post \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Our autumn collection is here. Twelve new pieces, all made in Porto.",
    "platforms": [
      { "platform": "instagram", "accountId": "6710c3e2a9f14b0d8e5c7a22" },
      { "platform": "twitter", "accountId": "6710c3e2a9f14b0d8e5c7a23" }
    ]
  }'

const res = await fetch("https://api.pozy.ai/v1/tools/validate/post", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.POZY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    content: "Our autumn collection is here. Twelve new pieces, all made in Porto.",
    platforms: [
      { platform: "instagram", accountId: "6710c3e2a9f14b0d8e5c7a22" },
      { platform: "twitter", accountId: "6710c3e2a9f14b0d8e5c7a23" },
    ],
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error);

if (!data.valid) for (const e of data.errors) console.log(`${e.platform}: ${e.error}`);

resp = requests.post(
    "https://api.pozy.ai/v1/tools/validate/post",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    json={
        "content": "Our autumn collection is here. Twelve new pieces, all made in Porto.",
        "platforms": [
            {"platform": "instagram", "accountId": "6710c3e2a9f14b0d8e5c7a22"},
            {"platform": "twitter", "accountId": "6710c3e2a9f14b0d8e5c7a23"},
        ],
    },
    timeout=30,
)
result = resp.json()
for e in result.get("errors", []):
    print(e["platform"], e["error"])

{
  "valid": false,
  "errors": [
    { "platform": "instagram", "error": "Instagram posts need at least one image or video." }
  ],
  "warnings": []
}

When everything passes, valid is true and message confirms it. warnings lists things that will publish but deserve a look, such as text above 90% of a platform's limit.

What it does not do: it does not check that the account is connected and healthy, and it does not download or process media. For accounts use account health; for files use validate/media below.

#Count characters per platform

POST /v1/tools/validate/post-length takes only text and returns a count, limit and verdict per platform:

{
  "text": "Our autumn collection is here. Twelve new pieces, all made in Porto.",
  "platforms": {
    "twitter": { "count": 69, "limit": 280, "valid": true },
    "twitterPremium": { "count": 69, "limit": 25000, "valid": true },
    "bluesky": { "count": 69, "limit": 300, "valid": true },
    "instagram": { "count": 69, "limit": 2200, "valid": true }
  }
}

X counts differently from the others: every link counts as 23 characters and most emoji count as 2. Two X rows come back because the limit depends on the account. twitter is the standard 280. twitterPremium applies only to accounts with a paid X subscription, and even those are held to 280 when the post has a poll. Since this endpoint never sees an account, trust validate/post with an accountId for the final answer.

Main text limits:

Per-platform pages list other limits, such as hashtag counts and title lengths.

#Check a media URL

POST /v1/tools/validate/media fetches the headers of a URL and tells you what it found:

{ "url": "https://example.com/files/autumn-lookbook.mp4" }

The response has valid, contentType, size (with a readable sizeFormatted), type (image, video or unknown), and platformLimits comparing the file with each platform's maximum size. A URL that is unreachable, private or returns a web page comes back with valid: false and an error you can show. Local and private network addresses are always refused.

#Ask TikTok before you post

TikTok limits how many posts some accounts can publish in a rolling 24 hours. To check before committing, send the normal create request with dryRun: true. Nothing is saved and no queue slot is claimed, so you can repeat it freely:

{
  "dryRun": true,
  "canPublish": false,
  "tiktok": [
    {
      "accountId": "6710c3e2a9f14b0d8e5c7a24",
      "canPublish": false,
      "alreadyPostedToday": false,
      "reason": "Daily active user quota reached"
    }
  ]
}

When canPublish is false, schedule the post a few hours out, or send it as a TikTok draft with tiktokSettings.draft: true, which lands in the creator's TikTok inbox and is not limited in the same way. See TikTok.

#Validate CSV files

For a spreadsheet of posts, POST /v1/posts/bulk-upload?dryRun=true validates every row at once. See CSV import.

GET /v1/tools/validate/subreddit is paused along with Reddit publishing and returns 503 until Reddit reopens its API.

#Endpoints