SuperAI Flow Platform

Sections

Theme switcher

Generate database upload URL

Generate a pre-signed URL for uploading files to a database.

Creates a temporary upload URL that allows direct file uploads to cloud storage without routing data through the API server. The URL expires after 1 hour.

This is the first step in the multi-step upload workflow:

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

Use Cases: - Upload CSV files for data import - Upload large datasets efficiently - Batch data ingestion

Security: - URL expires after 1 hour - File is uploaded to user-specific path - Metadata includes database ID for tracking

Header Parameters

Authorizationstring

Query Parameters

content_typestring

Path Parameters

db_idstring Required

Response

200
Object
Pre-signed upload URL generated successfully

Response Attributes

expires_atnull
file_keystring Required

Unique key identifying the file location in storage. Use this key to reference the file in subsequent operations.

upload_urlstring Required

Pre-signed URL for uploading file to cloud storage. Upload your file to this URL using PUT or POST request.

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
Database not found

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