Coordinate data processing tasks¶

Coordinate source processing task status. Only called when the task returns reconcile_required: true.

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

Before you call this API¶

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

First query the data processing task, and confirm that the task that returns reconcile_required: true exists in the knowledge base.

Set the operation-specific values used in the request:

$MODEL_ID: ID of the knowledge base whose task status is to be reconciled.

Request¶

Input examples

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

Parameter reference

Path parameters

Parameters	Type	Description
`model_id`	integer	The ID of the knowledge base to reconcile the status of the task.

Successful response¶

Returns 200 on success. Reread the task list to confirm final status; this interface is not a universal entry point for retrying all sources.

Response example

JSON
{
  "code": "OK",
  "msg": "OK",
  "data": {
    "updated": true
  }
}

Field reference

The response fields are as follows.

Field	Type	Description
`code`	string	`OK` on success.
`msg`	string	`OK` on success.
`data.updated`	boolean	`true` indicates that the service has executed task status convergence.

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 update 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 converge on the source task state.	Keep the desensitized response information and try again.

Follow-up operations¶

Query data processing tasks Confirm the final status of the task.

Last updated on Sep 15, 2026