Check whether a TikTok post finished publishing
tiktok_post_statusCheck the publish status of a TikTok post that returned pending:true, using its publishId. Returns done with the public URL, failed with TikTok's reason, or still processing.
Instructions
Follow a TikTok post that post_to_tiktok sent but TikTok was still processing (it came back pending:true). Pass the publishId it returned. Answers one of three states: done (PUBLISH_COMPLETE, with the public url once TikTok’s moderation has named it; urlStatus is ready, pending, private or draft), failed (with TikTok’s reason), or still processing, which is normal for a few minutes and is NOT a failure. Never post the video again while it is processing. Free, read-only. Needs TikTok connected (Connectors > TikTok).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"publishId": "<publishId>"
},
"name": "tiktok_post_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account | No | which connected TikTok account the post went out on (@handle or id from list_connector_accounts) when the profile has more than one | |
| publishId | Yes | the publishId post_to_tiktok returned |