Read a task, including legacy tasks without a publish job
curl --request GET \
--url https://api.creatok.ai/v1/publishing/tasks/{kind}/{task_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.creatok.ai/v1/publishing/tasks/{kind}/{task_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.creatok.ai/v1/publishing/tasks/{kind}/{task_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"task_id": "<string>",
"publish_job_id": "<string>",
"kind": "tiktok_shop_video",
"connection_uid": "<string>",
"client_source": "<string>",
"status": "queued",
"created_at": 123,
"cost": {
"amount_usd": "<string>",
"refunded_usd": "<string>"
},
"raw_status": "<string>",
"schedule_time": 123,
"completed_at": 123,
"result": {
"content_ids": [
"<string>"
],
"content_urls": [
"<string>"
]
},
"error": {}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"param": "<string>"
}
}Publishing
Read a task, including legacy tasks without a publish job
Read the current status, result, error, and booked wallet transactions for a task. Use the kind and task_id returned by submission or listing. Older tasks may have publish_job_id=null. Task timestamps use Unix milliseconds. Read result.content_ids and result.content_urls on success. Follow Retry-After for pending or unknown outcomes; unknown does not establish failure and must not trigger an automatic resubmission.
TikTok Shop only. The key creator must remain a workspace member with current account access. Read requests: 120/minute/workspace; writes: 30/minute/workspace (configurable). Media preparation and new submissions require Pro or higher. Video submission uses your API wallet; photos, reads, media preparation and cancellation are free. See https://www.creatok.ai/app/api-platform/pricing for current prices. Accepted tasks continue after plan downgrade. Unknown results are not automatically resent or refunded.
GET
/
publishing
/
tasks
/
{kind}
/
{task_id}
Read a task, including legacy tasks without a publish job
curl --request GET \
--url https://api.creatok.ai/v1/publishing/tasks/{kind}/{task_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.creatok.ai/v1/publishing/tasks/{kind}/{task_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.creatok.ai/v1/publishing/tasks/{kind}/{task_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"task_id": "<string>",
"publish_job_id": "<string>",
"kind": "tiktok_shop_video",
"connection_uid": "<string>",
"client_source": "<string>",
"status": "queued",
"created_at": 123,
"cost": {
"amount_usd": "<string>",
"refunded_usd": "<string>"
},
"raw_status": "<string>",
"schedule_time": 123,
"completed_at": 123,
"result": {
"content_ids": [
"<string>"
],
"content_urls": [
"<string>"
]
},
"error": {}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"param": "<string>"
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"request_id": "<string>",
"param": "<string>"
}
}Authorizations
Path Parameters
Response
Result