Skip to main content
GET
Error

Authorizations

x-cdata-authtoken
string
header
required

A Sync user auth token. Generate one via POST /v2/users/generate-token.

Path Parameters

job_id
string
required

Job identifier.

task_id
string
required

Task identifier.

Response

Task history records

task_id
string
job_history_id
string
affected_rows
integer
status
string

The task run status, e.g. SUCCESS, RETRY SUCCESS, PARTIAL_SUCCESS, RETRY PARTIAL_SUCCESS, FAILED, RETRY FAILED, ERROR, or SKIPPED. PARTIAL_SUCCESS (and RETRY PARTIAL_SUCCESS) indicates that at least one chunk succeeded and at least one chunk failed.

details
string

A detailed message for the status. For failed or partial-success tasks this is the error message; for successful tasks it is a summary such as "Records affected: N". Returned as a flat string for backward compatibility.

run_type
string | null

Replication run type reported by ReplicateEngine for upgraded jobs (statusversion >= 26.3), e.g. FULL_SNAPSHOT, INCREMENTAL_SNAPSHOT, PARTITIONED_SNAPSHOT, INCREMENTAL, or CDC. Null when unavailable.

start_position
string | null

Position the run started from, such as a timestamp or CDC position. Null when unavailable.

last_checkpoint
string | null

Last checkpoint reached by the run. Null when unavailable.

records_inserted
integer<int64> | null

Records inserted by the run, summed across automatic retries that keep previous writes. Null when unavailable.

records_merged
integer<int64> | null

Records merged by the run, summed across automatic retries that keep previous writes. Null when unavailable.

records_deleted
integer<int64> | null

Records deleted by the run, summed across automatic retries that keep previous writes. Null when unavailable.

error_message
string | null

Error message of a failed or partially successful completed run. Null otherwise.

query
string
table
string
runtime
string
run_start_at
string<date-time>
run_end_at
string<date-time>
instance_id
string
error
string