Unbind SKUs from FBT Goods
POST/api/tiktok-shop/:integrationInstance/fbt/goods/unbind
Remove the binding between one or more shop SKUs and an FBT goods record. An unbound SKU can no longer be added to an inbound plan.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Body
goods_id(integer, required) — the FBT goods record, addressed by its SKU.io id. It must belong to the integration instance in the path, otherwise the request answers404.sku_ids(array, required, 1–100 entries) — the TikTok shop SKU ids to change.sku_ids.*(string, required, max 64 characters) — one shop SKU id.
The change is made at TikTok first and only then recorded locally, so a SKU can never look bound here and fail at inbound time. TikTok can accept some SKUs and refuse others in the same call: the response splits them into bound (the ids it accepted) and failed (each with the tts_sku_id and TikTok's reason), and the message says how many of each.
Requires the integrations.update permission.
Request
Responses
- 200
- 401
- 403
- 404
- 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.
Unprocessable Content
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.