Trigger or resume a datasource sync job

POST 
/datasources/:datasource_id/sync-jobs

Starts a sync job for a datasource. The caller must have editor access. Supported datasource types are amorphic and jdbc with IngestionType set to metadataonly. Only one RUNNING or STARTING job can exist for a datasource at a time. External Amorphic and metadata-only ingestions use the external-assets Step Functions flow; other supported syncs either resume an eligible STOPPED/FAILED Glue job or start a new catalog Glue sync. Each request creates a new JobId.

Request

Responses

200

Job accepted. Message is "Datasource sync job triggered successfully" for fresh/external runs, or "Datasource sync job resumed successfully" for resume. JobId is the new run UUID.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

400

Validation or authorization failure. Body is {"Message": " - "}. Common codes: AUTH-1012 (no editor access), IPV-1045 (unknown datasource), IPV-1002 (invalid Resources or max_runtime_hours), IPV-1078 (job already running, or resume target missing/not STOPPED/FAILED).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

500

Backend failure (for example Glue/Step Functions start), or unsupported datasource type Message "Only Amorphic and Jdbc metadataonly type of datasources are allowed for this /sync-jobs operation".

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers