start_table_validation
Validate an uploaded table by checking for matching prior configurations or using provided instructions. Optionally bypass the interview with a config ID or natural-language description.
Instructions
Confirm the upload and detect matching prior configs.
Call this immediately after upload_file completes (or after the curl upload finishes when using HTTP/Railway transport). Returns config_matches with match_score — if score >= 0.85 a prior config can be reused directly.
instructions: Optional natural-language description of what to validate and how (e.g. "This table lists clinical trials — validate that trial IDs, phase, and primary endpoints are accurate"). When provided, the upload interview is bypassed: the AI reads the table structure + instructions and generates a config directly without asking clarifying questions. Preview is auto-triggered immediately after.
config_id: Optional ID of a known prior configuration to reuse directly. When provided, skips matching and the interview entirely — applies the config and queues the preview immediately. Response includes preview_queued=true and job_id. Use when you already know the config_id (e.g. from a previous job's get_results response).
Config generation and the 3-row preview are free. Full validation is charged at approve_validation — you still see the cost at preview_complete before anything is billed. If balance is insufficient at that point, approve_validation returns an insufficient_balance error.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| session_id | Yes | Session ID returned by upload_file. | |
| s3_key | Yes | S3 key returned by upload_file identifying the uploaded file. | |
| filename | Yes | Original filename of the uploaded file. | |
| instructions | No | Optional natural-language description of what to validate; bypasses the upload interview when provided. | |
| config_id | No | Optional ID of a prior configuration to reuse; skips the interview and queues the preview immediately. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |