Upload Seeds
Upload files or text content to create seeds in the Neutron system.
Endpoint
POST /seedsAuthentication
Required. Include your API key in the Authorization header.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | string | Yes | Application identifier |
| externalUserId | string | Yes | External user identifier for data isolation |
Request Body
Content-Type: multipart/form-data
Upload either files or text content (or both). When uploading files, include fileTypes, fileSources, and fileTitles (all arrays must have matching lengths). When uploading text, include textTypes, textSources, and textTitles.
| Field | Type | Description |
|---|---|---|
| files | File[] | Binary files to upload (max 10 files, 100MB total). Use with fileTypes and fileSources. |
| fileTypes | string[] | Type for each file (e.g., "pdf", "word", "image"). Array length must match files count. |
| fileSources | string[] | Origin identifier for each file (e.g., "upload", "chrome_extension"). Array length must match files count. |
| fileTitles | string[] | Display name for each file. Array length must match files count. |
| text | string[] | Text content to upload as seeds. Use with textTypes and textSources. |
| textTypes | string[] | Type for each text item (e.g., "text", "markdown", "claude_chat"). Array length must match text count. |
| textSources | string[] | Origin identifier for each text item (e.g., "upload", "chrome_extension"). Array length must match text count. |
| textTitles | string[] | Display name for each text item. Array length must match text count. |
| bundleIds | string[] | Bundle UUIDs to associate with uploaded seeds for grouping. |
Processing Pipeline
After successful upload, seeds are processed asynchronously:
1
Upload
Files uploaded to temporary storage
2
Extract
Background job extracts text/images
3
Convert
Content converted to markdown
4
Chunk
Chunked with dynamic token-based splitting
5
Embed
Embeddings generated (Jina Embeddings v4)
6
Store
Stored in database + cloud storage
Typical processing time: 5-30 seconds depending on file size and type.