Query data processing tasks¶

Query the processing tasks and status of knowledge base sources.

HTTP
GET $CLOUDSIGMA_API_BASE/semantic-models/{model_id}/source-jobs

Before you call this API¶

Configure the regional API endpoint and authentication, and select the target workspace.

First query the knowledge base list to obtain the knowledge base ID.

Set the operation-specific values used in the request:

$MODEL_ID: ID of the knowledge base to be queried.

Request¶

Input examples

Shell
curl "$CLOUDSIGMA_API_BASE/semantic-models/$MODEL_ID/source-jobs" \
  -H "X-API-Key: $CLOUDSIGMA_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

Parameter reference

Path parameters

Parameters	Type	Description
`model_id`	integer	Knowledge base ID.

Successful response¶

Returns 200 on success. Use job_status, error, and reconcile_required to determine whether a task completed, failed, or requires coordination.

Response example

JSON
{
  "code": "OK",
  "msg": "OK",
  "data": {
    "items": [
      {
        "job_id": "job_01",
        "source_id": "src_01",
        "job_status": "pending",
        "updated_at": 1735632000,
        "reconcile_required": false
      }
    ],
    "total": 1,
    "reconcile_required": false
  }
}

Field reference

The response fields are as follows.

Field	Type	Description
`code`	string	`OK` on success.
`msg`	string	`OK` on success.
`data.items`	object[]	Source processing task list.
`data.items[].job_id`	string	Task ID.
`data.items[].source_id`	string	The source ID associated with the task.
`data.items[].job_status`	string	Current processing status.
`data.items[].source_file_id`	string	Source file ID; may be omitted if not applicable.
`data.items[].source_table_id`	integer	Source table ID; may be omitted if not applicable.
`data.items[].error`	string	Reason for failure; may be omitted if there is no error.
`data.items[].updated_at`	integer	Unix timestamp; may be omitted if no value.
`data.items[].reconcile_required`	boolean	Whether the task requires state convergence.
`data.total`	integer	Total number of tasks.
`data.reconcile_required`	boolean	Whether there are tasks that require convergence in the current knowledge base.

In field paths, [] means each item in an array. For example, data.items[].job_id is the job_id field of each item in data.items.

Error response¶

Response example

JSON
{
  "code": "ErrNotFound",
  "msg": "resource not found",
  "data": null
}

Field reference

Common HTTP errors¶

HTTP status code	error code	Common causes	Recommended actions
`400`	`ErrParamInvalid`	`model_id` is invalid.	Use the knowledge base ID from the response.
`401`	`ErrUnauthorized`	The API Key is invalid or has expired.	Check API Key.
`403`	`ErrForbidden`	The caller does not have permission to read the source task.	Check workspace and object authorization.
`404`	`ErrNotFound`	The knowledge base does not exist or is not visible.	Reconfirm `model_id`.
`500`	`ErrServer`	The service failed to query the task.	Keep the desensitized response information and try again.

Follow-up operations¶

[Reconcile-data-processing-jobs.md] convergence status when any task or knowledge base returns reconcile_required to true.

Last updated on Sep 15, 2026