Update TikTok Post
PATCH/api/tiktok-posting/posts/:tikTokPost
Edits a post in draft, needs_approval, scheduled or failed. Send any subset of the Create TikTok Post fields.
tiktok-posts:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Any change clears the approval and the post goes back to needs_approval (a draft stays a draft) — except moving only scheduled_at of a scheduled post, which keeps the approval (the time is not part of what was approved) and still must be at least 5 minutes ahead. Sending publish applies that choice as on create.
Errors: 409 invalid_status when the post can no longer be edited; 422 for validation and account/video problems.
Scope: tiktok-posts:write. Permission: tiktok_posts.create.
Photo posts: send media_type=photo instead of a video:
- media_type (string, optional, default video): video or photo. Photo posts are only available once SKU.io's photo address is verified with TikTok (see photo_posts_available in List TikTok Accounts by Store); otherwise 422 "Photo posts aren't available yet"
- video_id: required for video posts; omit or null for photo posts
- photo_image_ids (integer[], required for photo posts): 1–35 distinct product image IDs, in the order they appear on TikTok. When product_id is set they must be that product's images
- photo_cover_index (integer, optional, default 0): which photo (0-based position in photo_image_ids) is the cover
- title (string, optional, photo posts only): up to 90 UTF-16 units
- caption: for a photo post this is TikTok's description, up to 4000 UTF-16 units
- allow_duet / allow_stitch are ignored for photo posts (TikTok has no Duet or Stitch for photos) TikTok fetches the photos itself, then the post follows the same statuses as a video. Changing the photos, their order, the cover or the title clears an approval.
Shoppable video (TikTok Shop product link): send these with a video post when the store's TikTok Shop official account is connected (see Get Store Shoppable Video Status):
- tiktok_shop_product_id (string of digits, optional, max 64): a product from Search TikTok Shop Products for Shoppable Videos. Send null on update to make the post a normal TikTok post again
- anchor_title (string, required with a product): the text on the product link, up to 30 letters or numbers; punctuation and emoji are removed
- shoppable_public_confirmed (boolean, required true unless publish=draft): shoppable videos post publicly through TikTok Shop, with no privacy, comment, Duet, Stitch or disclosure settings A shoppable post is always a video posted to the profile (mode direct); privacy_level is not needed. Videos over 10 MB are refused (422 shoppable_video_too_large). Before posting, TikTok Shop checks the video and product link; a failed check fails the post with TikTok Shop's reasons. Changing the product or anchor title clears an approval. The post carries publish_channel (content_posting or shoppable), tiktok_shop_product_id, anchor_title, shop_video_id, shop_precheck_status and shop_precheck_issues.
Request
Responses
- 200
- 401
- 403
- 404
- 409
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Conflict
Response Headers
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.