Onboard a new data source, step 2: run analysis after uploading
finish_data_source_onboardingCall ONLY after the file(s) returned by onboard_data_source have actually been uploaded (each PUT returned HTTP 200) — kicks off AI analysis and waits until the spec reaches "ready" or "failed".
This tool verifies the upload against storage before starting anything. If a file is not there it refuses, spends no credits, and returns a fresh upload URL plus the exact curl command — complete the upload and call this again. Calling it in the hope that analysis will work without the upload cannot succeed; if you have no filesystem access, ask the user to attach the file and upload it first.
If it returns before the spec settles (timedOut: true), do NOT call this tool again just to keep checking — that re-attempts starting analysis. Poll with get_status (specId) instead until it reaches a terminal status.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| specId | Yes | specId returned by onboard_data_source. | |
| specName | Yes | Name of the data spec being onboarded. | |
| workspaceId | No | Workspace to act on. Defaults to your only workspace if you have exactly one. | |
| loadSampleData | No | Whether to load the sample file and trigger the data-load job once analysis finishes (default true). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | ||
| specId | No | ||
| status | No | "processing" | "ready" | "failed" | |
| message | Yes | ||
| progress | No | ||
| timedOut | No | ||
| lastJobId | No | ||
| workspaceId | No | ||
| errorDetails | No | ||
| statusMessage | No | ||
| analysisEndTime | No | ||
| analysisStartTime | No | ||
| analysisDurationMs | No | ||
| hasTransformationConfig | No |