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
      • GETGet mind by ID
      • PUTUpdate mind by ID
      • DELDelete mind by ID
      • POSTRun simulation
      • GETGet signed URL for artifact upload
      • GETGet memory bank snapshots
      • POSTCreate a memory bank snapshot
      • GETGet memory bank snapshot status
      • GETGet all tags
      • PUTUpdate a tag
      • DELDelete a tag
      • PUTSet tags for a mind
      • GETList simulations
      • GETGet a simulation
      • DELDelete a simulation
      • GETGet psychometrics for a snapshot
      • GETGet topic analysis for a snapshot
      • GETGet snapshot details
      • POSTCreate a snapshot link
      • DELDelete a snapshot
      • POSTLink a snapshot
      • POSTUnlink a snapshot
      • GETGet API Key Usage
      • POSTProxy a request
    • Error Handling
  • SDKs
  • Core Concepts
    • Minds, Snapshots, & Simulations
    • SOC 2, HIPAA, & GDPR
LogoLogo
LogoLogo
Direct APIAPI Reference

Create a memory bank snapshot

POST
https://api.reasoner.com/api/mindsim/minds/:mindId/snapshots
POST
/api/mindsim/minds/:mindId/snapshots
$curl -X POST https://api.reasoner.com/api/mindsim/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.
mindsetDatestring or nullOptionalformat: "date-time"
Optional date and time to associate with this assessment. The mindsetDate is used to establish chronology of mind assessments. If not provided, defaults to now.

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