Skip to main content

Documentation Index

Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
content
string
required
The text content of the post.
​
title
string
Post title. Auto-generated from content (first 100 chars) if omitted.
​
platforms
string[]
required
Platforms to post to. e.g. ["TWITTER", "LINKEDIN"].
​
platform_data
object
Platform-specific overrides keyed by platform name, e.g. { "TWITTER": { "text": "shorter version" } }.
​
media_urls
string[]
URLs of media to attach (use POST /v1/social/upload first for reliable hosting).
​
youtube_type
string
Required when posting to YouTube. One of SHORT or VIDEO.
​
publish_now
boolean
If true, the post is published immediately. Default false (creates a draft).
​
scheduled_at
string
ISO 8601 timestamp to schedule the post for future publishing. Ignored if publish_now is true.
​
account_ids
string[]
Specific account UUIDs to post from. If omitted, posts to all connected accounts for the given platforms.
curl -X POST https://api.usenaive.ai/v1/social/posts \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "We just launched Naive v2 — the all-in-one API.",
    "platforms": ["TWITTER", "LINKEDIN"]
  }'

{
  "id": "post-uuid",
  "status": "draft",
  "platforms": ["TWITTER", "LINKEDIN"],
  "hint": "Draft created. Publish with POST /v1/social/posts/post-uuid/publish"
}
Cost: 1 credit when publishing (immediately or scheduled). Drafts are free.