Adds PostizAPI.listMedia and a `postiz media:list [--search] [--page]`
command backed by GET /public/v1/media (gitroomhq/postiz-app#1926), and
updates SKILL.md, QUICK_START.md, FEATURES.md and CHANGELOG.md so agents
look for an existing upload before uploading a file again.
Tested: build passes; media:list, --search and --page verified against a
backend running the new endpoint; a second agent followed SKILL.md end to
end and created a draft post with a path returned by media:list.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Add `postiz posts:settings <id> --settings '<json>'` calling
PUT /public/v1/posts/:id/settings to patch a post's provider-specific
settings without recreating it. Modeled on the existing posts:status
command. Settings are merged server-side (only passed keys change);
only DRAFT/QUEUE posts can be updated.
Also document that posts:list responses now include each post's current
`settings` (returned as a JSON string).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
A user ticked "Video made with AI" on an UPLOAD post and the label was
silently dropped: TikTok's inbox endpoint accepts no post_info, and
within DIRECT_POST duet/stitch/video_made_with_ai are video-only while
autoAddMusic is photo-only. postiz-app PR #1728 fixed the app side;
this catches the skill docs up.
- PROVIDER_SETTINGS.md: spell out the two axes and tag every TikTok
setting (DIRECT_POST-only; video-only / photo-only / both); stop
presenting autoAddMusic as generally required and drop it from the
video example.
- SKILL.md: add generic Rule 4 — fetch integrations:settings before
scheduling and honor the returned rules + per-field descriptions;
fix the example's wrong "privacy" key to privacy_level.
- README.md: same key fix; complete the settings table row.
- PROVIDER_SETTINGS_SUMMARY.md: complete the TikTok row (was missing
content_posting_method, video_made_with_ai, brand toggles); remove
autoAddMusic from the video example.
- INTEGRATION_SETTINGS_DISCOVERY.md: one behavioral line per axis;
autoAddMusic no longer listed as required.
- examples/tiktok-video.json: drop photo-only autoAddMusic from the
video post.
Extends a557cd5 (UPLOAD never publishes) with the media-type axis.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
UPLOAD sends the media to the user's TikTok app inbox (SEND_TO_USER_INBOX),
where it must be finished manually within 24h or it is discarded. The API
still reports the post as successful, so an agent that picks UPLOAD - the
natural choice when a user says "upload this video" - silently never posts.
PROVIDER_SETTINGS.md listed the enum with no explanation, and it is what an
agent following this skill actually reads. Spell out the consequence and
name DIRECT_POST as the default.
Also stop the integrations:settings example from discarding .output.rules,
so provider guidance written upstream reaches skill users.
Mirrors gitroomhq/postiz-app#1687 and the parallel gitroomhq/postiz-docs fix.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- Add npm badge and AGPL-3.0 badge
- Update repository URL to postiz-agent
- Streamline README for standalone project
- Keep all detailed docs in separate markdown files
- Complete CLI for Postiz social media automation
- Support for 28+ platforms (Twitter/X, LinkedIn, Reddit, YouTube, TikTok, Instagram, etc.)
- Required date scheduling with schedule/draft modes
- Integration tools workflow for dynamic data fetching
- Platform-specific settings auto-detection
- Comprehensive documentation for AI agents
Features:
- posts:create - Create scheduled posts with media
- posts:list - List posts with date filtering
- posts:delete - Delete posts
- integrations:list - List connected integrations
- integrations:settings - Get platform settings and tools
- integrations:trigger - Fetch dynamic data (flairs, playlists, companies)
- upload - Upload media files
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Gilad Resisi