SuperAI Flow Platform

Sections

Theme switcher

Generate file upload URL

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

Creates a temporary upload URL that allows direct file upload to cloud storage without exposing storage credentials. Each URL is valid for 1 hour.

Upload Process

  1. Call this endpoint to receive an upload URL
  2. Use PUT request to upload your file to the returned upload_url
  3. Save the returned file_key to reference the file later
  4. File becomes accessible via the flow immediately after upload

Supported File Types

  • Documents: PDF, DOCX, TXT, CSV
  • Images: PNG, JPG, GIF
  • Archives: ZIP, TAR
  • Maximum file size: 100MB

Header Parameters

Authorizationstring

Query Parameters

content_typestring

MIME type of file to upload (e.g., 'application/pdf', 'image/png')

Path Parameters

flow_idstring Required

Response

200
Object
Pre-signed upload URL successfully generated
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
Not Found - The requested resource does not exist

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