CLI command reference

Usage: postinger [options] [command]

Manage Postinger through its project-scoped public API.

Options:
  -V, --version    output the version number
  --api-url <url>  Backend origin or /public/v1 URL; defaults to saved URL or
                   https://api.dev.postinger.dev
  --json           Machine-readable result and structured errors
  -h, --help       display help for command

Commands:
  auth             Sign in through the browser or configure an API key.
  doctor           Check Node.js, CLI version, API authentication and effective
                   permissions
  accounts         Connected accounts (accounts-read)
  upload <file>    Upload JPEG, PNG, MP4 or MOV; returns a ready media ID
                   (media-write)
  posts            Drafts, scheduling and publishing
  media            Signed upload workflow (media-read/media-write)
  analytics        Stored analytics only (analytics-read); never requests live
                   collection
  help [command]   display help for command

Usage: postinger auth [options] [command]

Sign in through the browser or configure an API key.

Options:
  -h, --help        display help for command

Commands:
  login [options]
  status
  logout [options]
  help [command]    display help for command

Usage: postinger auth login [options]

Options:
  --key-stdin    Read API key from piped stdin and store with owner-only file
                 permissions
  --no-browser   Print the authorization link without opening a browser
  --name <name>  Device name shown in Connected apps (default: "Postinger CLI ·
                 <hostname>")
  -h, --help     display help for command

Usage: postinger auth status [options]

Options:
  -h, --help  display help for command

Usage: postinger auth logout [options]

Options:
  --local     Remove local credentials only; keep server access
  -h, --help  display help for command

Usage: postinger doctor [options]

Check Node.js, CLI version, API authentication and effective permissions

Options:
  -h, --help  display help for command

Usage: postinger accounts [options] [command]

Connected accounts (accounts-read)

Options:
  -h, --help                display help for command

Commands:
  list
  capabilities <accountId>  Read current publishing rules and account
                            availability (accounts-read)
  help [command]            display help for command

Usage: postinger accounts list [options]

Options:
  -h, --help  display help for command

Usage: postinger accounts capabilities [options] <accountId>

Read current publishing rules and account availability (accounts-read)

Options:
  -h, --help  display help for command

Usage: postinger upload [options] <file>

Upload JPEG, PNG, MP4 or MOV; returns a ready media ID (media-write)

Options:
  -h, --help  display help for command

Usage: postinger posts [options] [command]

Drafts, scheduling and publishing

Options:
  -h, --help              display help for command

Commands:
  list [options]
  get <id>
  create [options]        Create a draft (posts-write); --scheduled-at also
                          needs posts-publish
  update [options] <id>
  publish [options] <id>  Request immediate publication (posts-publish);
                          accepted is not yet published
  delete [options] <id>   Delete a post (posts-delete)
  help [command]          display help for command

Usage: postinger posts list [options]

Options:
  --limit <n>        Page size, 1–100
  --after <uuid>     nextCursor from the previous page
  --status <status>
  --platform <name>
  --q <text>
  -h, --help         display help for command

Usage: postinger posts get [options] <id>

Options:
  -h, --help  display help for command

Usage: postinger posts create [options]

Create a draft (posts-write); --scheduled-at also needs posts-publish

Options:
  --content <text>         Post text
  --account <uuid>         Target account; repeat for multiple accounts
                           (default: [])
  --media <uuid>           Existing media ID; repeat to preserve ordering
                           (default: [])
  --scheduled-at <iso>     Schedule with explicit timezone/offset
  --file <path>            Full JSON body; - reads stdin; cannot combine with
                           content/target/media/schedule flags
  --idempotency-key <key>  Reuse the same key and payload for retries (24 hours)
  -h, --help               display help for command

Usage: postinger posts update [options] <id>

Options:
  --file <path>  JSON patch; - reads stdin. Omitted fields remain unchanged.
  -h, --help     display help for command

Usage: postinger posts publish [options] <id>

Request immediate publication (posts-publish); accepted is not yet published

Options:
  --account-id <uuid>      Publish only this target
  --idempotency-key <key>
  --yes                    Confirm publication to connected social accounts
  -h, --help               display help for command

Usage: postinger posts delete [options] <id>

Delete a post (posts-delete)

Options:
  --yes       Confirm deletion
  -h, --help  display help for command

Usage: postinger media [options] [command]

Signed upload workflow (media-read/media-write)

Options:
  -h, --help                display help for command

Commands:
  upload <file>             Upload a local image or video (media-write)
  create-upload [options]
  get <id>
  complete <id>             Validate the file after uploading bytes to the
                            signed URL
  multipart [options] <id>
  help [command]            display help for command

Usage: postinger media upload [options] <file>

Upload a local image or video (media-write)

Options:
  -h, --help  display help for command

Usage: postinger media create-upload [options]

Options:
  --filename <name>
  --content-type <type>
  --size-bytes <n>       File size
  -h, --help             display help for command

Usage: postinger media get [options] <id>

Options:
  -h, --help  display help for command

Usage: postinger media complete [options] <id>

Validate the file after uploading bytes to the signed URL

Options:
  -h, --help  display help for command

Usage: postinger media multipart [options] <id>

Options:
  --operation <operation>  (choices: "list", "sign", "complete", "abort")
  --part-number <n>        Part number for sign
  -h, --help               display help for command

Usage: postinger analytics [options] [command]

Stored analytics only (analytics-read); never requests live collection

Options:
  -h, --help                    display help for command

Commands:
  capabilities
  report [options]
  account [options] <id>
  posts [options]
  history <postId> <accountId>  Latest 1000 retained observations, oldest first
  help [command]                display help for command

Usage: postinger analytics capabilities [options]

Options:
  -h, --help  display help for command

Usage: postinger analytics report [options]

Options:
  --from <date>        First inclusive UTC date (YYYY-MM-DD)
  --to <date>          Last inclusive UTC date, at most 366 days
  --account-id <uuid>  Filter by connected account
  --platform <name>    Filter platform (choices: "instagram", "facebook",
                       "youtube", "tiktok")
  -h, --help           display help for command

Usage: postinger analytics account [options] <id>

Options:
  --from <date>  First inclusive UTC date (YYYY-MM-DD)
  --to <date>    Last inclusive UTC date, at most 366 days
  -h, --help     display help for command

Usage: postinger analytics posts [options]

Options:
  --account-id <uuid>  Filter by connected account
  --platform <name>    Filter platform (choices: "instagram", "facebook",
                       "youtube", "tiktok")
  --days <n>           7, 30 or 90; default 30
  --from <date>
  --to <date>
  --limit <n>          1–100
  --cursor <cursor>
  -h, --help           display help for command

Usage: postinger analytics history [options] <postId> <accountId>

Latest 1000 retained observations, oldest first

Options:
  -h, --help  display help for command