UPLOAD

upload_file_to_signed_url

Uploads a local transcript file to Mind Reasoner’s secure cloud storage using a signed URL. The file is uploaded directly from your system to storage.

No data passes through the AI assistant—files go straight from your system to secure cloud storage.

Parameters

signedUrl

Type	string
Required	Yes
Description	The signed URL from the `get_signed_upload_url` response

filePath

Type	string
Required	Yes
Description	Absolute path to your transcript file
Example	`/Users/name/Documents/transcript.vtt`

contentType

Type	string
Required	Yes
Description	MIME type matching your file format
Valid values	`text/vtt`, `application/pdf`, or `application/vnd.openxmlformats-officedocument.wordprocessingml.document`

Request

1 {
2   "signedUrl": "https://storage.googleapis.com/mind-reasoner/uploads/...",
3   "filePath": "/Users/yourname/Documents/transcript.vtt",
4   "contentType": "text/vtt"
5 }

Response

1 {
2   "success": true,
3   "message": "File uploaded successfully",
4   "uploadedBytes": 1048576,
5   "fileName": "transcript.vtt"
6 }

Response Properties

Property	Type	Description
`success`	boolean	Upload status (true if successful)
`message`	string	Human-readable confirmation message
`uploadedBytes`	number	Size of uploaded file in bytes
`fileName`	string	Name of the uploaded file

Once you receive a success response, your file is securely stored and ready for processing.

File Path Requirements

Use absolute paths: /Users/name/Documents/file.vtt

Don’t use relative paths: ./file.vtt or ../Documents/file.vtt

Before uploading:

Verify the file exists at the specified path
Ensure file permissions allow reading
Confirm the file isn’t corrupted or empty
Match contentType to the actual file extension

Common Issues

Issue	Cause	Solution
File not found	Incorrect path or file moved	Use absolute path; verify file exists
Permission denied	File is not readable	Check file permissions; use `chmod 644` if needed
Content type mismatch	Wrong MIME type specified	Ensure content type matches file extension
URL expired	Signed URL older than 1 hour	Request new URL with `get_signed_upload_url`
File too large	File exceeds 100MB limit	Compress or split the file

Error Responses

File Not Found

1 {
2   "error": "File Not Found",
3   "message": "No file exists at path '/Users/name/transcript.vtt'"
4 }

Solution: Verify the path is correct and use absolute paths, not relative paths. Ensure the file wasn’t moved or deleted.

Permission Denied

1 {
2   "error": "Permission Denied",
3   "message": "Cannot read file at path '/Users/name/transcript.vtt'"
4 }

Solution: Check file permissions with ls -l and make the file readable with chmod 644 if needed.

Upload Failed

1 {
2   "error": "Upload Failed",
3   "message": "Failed to upload file to storage",
4   "details": "URL expired or invalid"
5 }

Solution: Check if the signed URL expired (1-hour limit) and request a new signed URL if needed.

Next Steps

Create Snapshot

create_snapshot - Process the uploaded file into a trained AI model