get_signed_upload_url

Request a secure URL for file uploads

get_signed_upload_url

Request a secure URL for file uploads

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

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

get_signed_upload_url

get_signed_upload_url

get_signed_upload_url

Parameters

mindId

Request

Response

Response Properties

Supported File Formats

.vtt Files

.pdf Files

.docx Files

File Size Guidelines

Error Responses

404 Not Found

401 Unauthorized

429 Rate Limit Exceeded

Next Steps

Upload File

See Also

get_signed_upload_url

Parameters

mindId

Request

Response

Response Properties

Supported File Formats

.vtt Files

.pdf Files

.docx Files

File Size Guidelines

Error Responses

404 Not Found

401 Unauthorized

429 Rate Limit Exceeded

Next Steps

Upload File

See Also

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

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

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

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