Get Submission Tool
get-submission-toolFetch a single video submission the authenticated user is allowed to view, on any platform — TikTok, Instagram or YouTube. Use it to poll a submission until status is final. Statuses: scheduled (waiting for scheduled_at), pending (queued), ingesting (sending the video to the phone), driving (the phone is posting), then one of the final states published, drafted, failed (see failure) or cancelled.
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": {
"submission_id": "<submission_id>"
},
"name": "get-submission-tool"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| submission_id | Yes | ID of the submission to fetch, on any platform. |