SuperAI Flow Platform

Sections

Theme switcher

Preview CSV file before import

Preview CSV file before final import.

Shows the first 5 rows and file metadata to help users:

  • Verify correct file was uploaded
  • Confirm header row detection
  • Check delimiter parsing
  • Review column names
  • Validate data format

This is step 3 in the upload workflow (optional):

  1. Generate upload URL
  2. Upload file to cloud storage
  3. Preview file (this endpoint)
  4. Complete upload and process

Use Cases: - Verify file structure before import - Confirm CSV parsing settings - Preview data for validation

Header Parameters

Authorizationstring

Path Parameters

db_idstring Required

Response

200
Object
CSV preview generated successfully

Response Attributes

headersarray Required

Column headers from the CSV file. If has_header=false, generated as column_1, column_2, etc.

Show child attributes

metadataobject Required

File metadata and statistics

Show child attributes

preview_rowsarray Required

First 5 data rows from the CSV file for preview

Show child attributes

400
Object
Invalid request - missing upload_id or empty CSV file

Response Attributes

errorobject Required

Standard error detail structure.

This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.

Show child attributes

request_idnull
401
Object
Unauthorized - Missing or invalid authentication credentials

Response Attributes

errorobject Required

Standard error detail structure.

This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.

Show child attributes

request_idnull
404
Object
File not found with the specified upload_id

Response Attributes

errorobject Required

Standard error detail structure.

This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.

Show child attributes

request_idnull
422
Object
Validation Error

Response Attributes

detailarray

Show child attributes

500
Object
Internal Server Error - An unexpected error occurred

Response Attributes

errorobject Required

Standard error detail structure.

This model matches the error format returned by the centralized exception handlers in app/api/errors/handlers.py.

Show child attributes

request_idnull
Was this section helpful?

What made this section unhelpful for you?

POST

/

Select
1

Response

Was this section helpful?

What made this section unhelpful for you?

View as Markdown

Ask an AI

Open in ChatGPTOpen in ClaudeOpen in Perplexity

Code with AI

Open in Copilot