GET

get_signed_upload_url

Generates a secure, time-limited URL for uploading transcript files to Mind Reasoner. The URL expires after 1 hour.

For security, Mind Reasoner doesn’t accept direct file uploads. This tool generates a signed URL that grants temporary upload permission.

Parameters

mindId

Type	string
Required	Yes
Description	The mind ID from the `create_mind` response

Request

1 {
2   "mindId": "abc-123-def-456"
3 }

Response

1 {
2   "signedUrl": "https://storage.googleapis.com/bucket/path?signature=...",
3   "fileName": "1234567890_uuid.vtt",
4   "artifactId": "123e4567-e89b-12d3-a456-426614174004"
5 }

Response Properties

Property	Type	Description
`signedUrl`	string	Pre-signed upload URL (expires in 1 hour). Use with `upload_file_to_signed_url`
`fileName`	string	Generated safe filename for the artifact
`artifactId`	string	Required for snapshots - Artifact identifier for use with `create_snapshot`

Supported File Formats

.vtt Files

Content-Type: text/vtt

Best for video call transcripts from Zoom, Teams, or Google Meet. Includes timestamps and speaker attribution.

.pdf Files

Content-Type: application/pdf

Best for documents, reports, and meeting notes. Preserves formatting and structure.

.docx Files

Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document

Best for Word documents and formatted transcripts. Easy to create and edit.

File Size Guidelines

Category	Size	Training Quality
Optimal	Under 10MB	Fast processing, good quality
Recommended	10-50MB	Balanced speed and accuracy
Maximum	100MB	Longer processing, highest accuracy

Minimum data required: 30-50 conversations or 5,000+ words

Error Responses

404 Not Found

1 {
2   "error": "Not Found",
3   "message": "Mind with ID 'abc-123' does not exist"
4 }

Solution: Verify the mindId is correct and ensure the mind wasn’t deleted. Check you’re using the mind ID, not the digital twin ID.

401 Unauthorized

1 {
2   "error": "Unauthorized",
3   "message": "Invalid or missing API key"
4 }

Solution: Verify your API key in the MCP server configuration and ensure the format is correct: Bearer YOUR_KEY.

429 Rate Limit Exceeded

1 {
2   "error": "Too Many Requests",
3   "message": "Rate limit exceeded. Retry after 60 seconds",
4   "retryAfter": 60
5 }

Solution: Wait for the specified time before making additional requests.

Next Steps

Upload File

upload_file_to_signed_url - Upload your transcript file using the signed URL