Managing Posts

Creating posts

nadia post schedules, publishes or drafts a post on one or more channels. Local media are uploaded first.

nadia post \
  -i "$IG" \
  -s 2026-10-02T09:00:00+02:00 \
  -c "Three places in Malta" \
  -m ./photo.jpg

Flag	Description
`-i, --integrations`	Channel ids, comma-separated (see `nadia channels`)
`-s, --date`	Publication date, ISO 8601 (not needed with `-t now`)
`-t, --type`	`schedule` (default), `now` or `draft`
`-c, --content`	Text, or `@file` to read it from a file; repeat `-c` for a thread
`-m, --media`	Media of the `-c` before it, comma-separated; local files are uploaded, URLs used as they are
`--settings`	Provider settings, as JSON or `@file`, applied to every channel
`-d, --delay`	Delay between the comments of a thread, in milliseconds

Draft, or now

nadia post -t draft -i "$IG" -s 2026-10-02T09:00:00+02:00 -c "Review this first" -m ./photo.jpg
nadia post -t now   -i "$IG" -c "Live" -m ./photo.jpg

Threads

Every -m belongs to the -c typed before it, so a thread keeps its images:

nadia post -i "$THREADS" -s 2026-10-02T09:00:00+02:00 \
  -c "1/3 — the rent" -m ./rent.png \
  -c "2/3 — the paperwork" -m ./forms.png \
  -c "3/3 — the weather" \
  -d 2000

Several channels

nadia post -i "$IG,$TIKTOK" -s 2026-10-02T09:00:00+02:00 -c "Same video everywhere" -m ./reel.mp4

--settings applies to every channel. When they need different settings or different text, see the full body below.

The full body

For anything post does not cover — a different text per channel, tags, short links — send the whole request of Create a post to the generated command:

nadia create-post --body @post.json

{
  "type": "schedule",
  "date": "2026-10-02T07:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": { "id": "instagram-id" },
      "value": [{ "content": "Instagram version, with hashtags.", "image": [] }],
      "settings": { "__type": "instagram-standalone", "post_type": "post" }
    },
    {
      "integration": { "id": "tiktok-id" },
      "value": [{ "content": "Shorter TikTok version.", "image": [] }],
      "settings": { "__type": "tiktok", "content_posting_method": "DIRECT_POST", "privacy_level": "PUBLIC_TO_EVERYONE" }
    }
  ]
}

Listing posts

nadia posts                                    # a week back, four weeks ahead
nadia posts --from 2026-10-01 --to 2026-10-31  # a date range
nadia posts --channel "$IG"                    # one channel
nadia posts --group "$GROUP"                   # one group

nadia find-slot <channel-id> gives the next free slot in a channel’s schedule.

Pausing and resuming

Move a post between draft and schedule without changing its date:

nadia change-post-status <post-id> --status draft
nadia change-post-status <post-id> --status schedule

--status schedule puts a draft back in the publishing queue, to go out at its stored date.
--status draft takes a scheduled post out of the queue and stops any running publication, so it will not go out.

Deleting posts

nadia delete-post <post-id>          # the post and everything published with it
nadia delete-post-group <group>      # the whole publication group

Connecting a post to what was published

Some providers do not return the published post’s id (TikTok in inbox mode, for instance): the post’s releaseId is then "missing", and its analytics have nothing to read. List what the provider has published recently, and record the right one:

# 1. Posts without a release id
nadia posts | jq '.posts[] | select(.releaseId == "missing") | {id, content}'

# 2. What the provider published recently
nadia list-missing-media <post-id>

# 3. Record the right one
nadia set-post-release-id <post-id> --release-id 7321456789012345678

# 4. The post now has analytics
nadia get-post-analytics <post-id> --date 7

list-missing-media returns { id, url } items, url being the thumbnail.