For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • Workflows
    • Overview
  • Get Started
    • MCP Quick Start
    • API Quick Start
  • MCP Server
    • Overview
    • Installation
  • Direct API
    • Overview
    • Authentication
      • GETGet all minds
      • POSTCreate a new mind
      • GETSearch minds
      • POSTRun simulation
      • GETGet signed URL for artifact upload
      • POSTCreate a memory bank snapshot
      • GETGet memory bank snapshot status
    • Error Handling
  • Core Concepts
    • Minds, Snapshots, & Simulations
    • SOC 2, HIPAA, & GDPR
LogoLogo
LogoLogo
Direct APIAPI Reference

Create a memory bank snapshot

POST
https://app.mindreasoner.com/api/public/v1/minds/:mindId/snapshots
POST
/api/public/v1/minds/:mindId/snapshots
$curl -X POST https://app.mindreasoner.com/api/public/v1/minds/123e4567-e89b-12d3-a456-426614174000/snapshots \
> -H "Authorization: Bearer <token>" \
> -H "Content-Type: multipart/form-data" \
> -F file=@<file1>
1{
2 "message": "Memory bank snapshot processing initiated",
3 "mindAssessmentId": "123e4567-e89b-12d3-a456-426614174003",
4 "artifactId": "123e4567-e89b-12d3-a456-426614174004"
5}
Creates a new memory bank snapshot from either an uploaded file or an existing artifact. Accepts VTT, DOCX, or PDF files up to 50MB. The snapshot will be processed asynchronously.
Was this page helpful?
Previous

Get memory bank snapshot status

Next
Built with

Authentication

AuthorizationBearer

API key passed as Bearer token in Authorization header (e.g., “Authorization: Bearer YOUR_API_KEY”)

Path parameters

mindIdstringRequiredformat: "uuid"

Request

This endpoint expects a multipart form containing an optional file.
filefileOptional

Transcript file (VTT, DOCX, or PDF format, max 4MB). Required if artifactId is not provided.

artifactIdstringOptionalformat: "uuid"
ID of an existing artifact. Required if file is not provided.
digitalTwinIdstringOptionalformat: "uuid"
Optional digital twin ID to associate with this assessment

Response

Memory bank snapshot created and processing initiated
messagestring
Status message
mindAssessmentIdstring
ID of the created memory bank snapshot
artifactIdstring
ID of the associated artifact

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error