v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1415122102.4 KB

The DescribeTableDataImportJob API allows you to retrieve the status and details of a table data import job.

get/workbooks/{workbookId}/tables/{tableId}/import/{jobId}

Path parameters

workbookIdstring required
<p>The ID of the workbook into which data was imported.</p> <p> If a workbook with the specified id could not be found, this API throws ResourceNotFoundException. </p>
tableIdstring required
<p>The ID of the table into which data was imported.</p> <p> If a table with the specified id could not be found, this API throws ResourceNotFoundException. </p>
jobIdstring required
<p>The ID of the job that was returned by the StartTableDataImportJob request.</p> <p> If a job with the specified id could not be found, this API throws ResourceNotFoundException. </p>

Response

Success

jobStatus'SUBMITTED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' required

The current status of the import job.

messagestring required

A message providing more details about the current status of the import job.

errorCode'ACCESS_DENIED' | 'INVALID_URL_ERROR' | 'INVALID_IMPORT_OPTIONS_ERROR' | 'INVALID_TABLE_ID_ERROR' | 'INVALID_TABLE_COLUMN_ID_ERROR' | 'TABLE_NOT_FOUND_ERROR' | 'FILE_EMPTY_ERROR' | 'INVALID_FILE_TYPE_ERROR' | 'FILE_PARSING_ERROR' | 'FILE_SIZE_LIMIT_ERROR' | 'FILE_NOT_FOUND_ERROR' | 'UNKNOWN_ERROR' | 'RESOURCE_NOT_FOUND_ERROR' | 'SYSTEM_LIMIT_ERROR'

If job status is failed, error code to understand reason for the failure.