Skip to content

docs(tiktok): mark each setting's posting-method and media-type axes - #12

Open
giladresisi wants to merge 1 commit into
docs/tiktok-posting-methodfrom
docs/tiktok-settings-axes
Open

docs(tiktok): mark each setting's posting-method and media-type axes#12
giladresisi wants to merge 1 commit into
docs/tiktok-posting-methodfrom
docs/tiktok-settings-axes

Conversation

@giladresisi

Copy link
Copy Markdown
Collaborator

Stacked on #11 (docs/tiktok-posting-method). Review/merge that first; GitHub will auto-retarget this PR to main once it merges. The diff below shows only the media-type change.

Why

A production user ticked "Video made with AI" on a TikTok post that used the UPLOAD posting method, and the label was silently dropped. Even within DIRECT_POST, several TikTok settings only apply to one media type — a setting sent on the wrong axis is discarded while the API still reports success.

The app side was fixed in gitroomhq/postiz-app#1728 (hides settings TikTok silently ignores, adds @JSONSchema descriptions and provider @Rules). An agent following this skill reads the static docs in this repo, not the postiz-app source, so those docs need to match.

Two independent axes (verified against TikTok's API reference and postiz-app's buildTikokPostInfoBody)

  1. Posting method — every TikTok setting except title requires DIRECT_POST (established in docs(tiktok): warn that content_posting_method UPLOAD never publishes #11).
  2. Media type (within DIRECT_POST):
    • Video-only: duet, stitch, video_made_with_ai
    • Photo-only: autoAddMusic
    • Both: privacy_level, comment, brand_content_toggle, brand_organic_toggle

Changes (docs/markdown only)

  • PROVIDER_SETTINGS.md — spell out both axes; tag every TikTok setting (DIRECT_POST-only; video-only / photo-only / both). autoAddMusic is no longer presented as generally required and is dropped from the video example (it's photo-only).
  • SKILL.md — add generic Rule 4: fetch integrations:settings before scheduling and honor the returned rules + per-field descriptions (inapplicable settings are silently discarded, not rejected). Fix the example's wrong "privacy" key → privacy_level.
  • README.md — same "privacy"privacy_level 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); drop 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.

Related

🤖 Generated with Claude Code

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>
@postiz-contribution postiz-contribution Bot added the contribution:approved Approved contributor label Jul 20, 2026
@postiz-contribution

Copy link
Copy Markdown

Contribution-checker quality warning
Heuristic score: 3/100 (low). This is a non-blocking warning surfaced by the project's quality settings.

Heuristics that flagged:

  • Excessive inline code references: 30 inline refs (>3)
  • AI watermark phrase: Matched: "Generated with Claude Code"
  • Commit message too long: Longest: 1350 chars
  • Cross-module sprawl: 6 top-level dirs

If this is a genuine contribution, please add detail to your PR description and tighten the diff scope before reviewers look at it.

@coderabbitai

coderabbitai Bot commented Jul 20, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: cbbcba1b-4ef8-42fc-b080-179b884e44f3

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/tiktok-settings-axes

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

contribution:approved Approved contributor

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant