Create a new mind | Mind Reasoner API Documentation

1 import requests 2 3 url = "https://app.mindreasoner.com/api/public/v1/minds" 4 5 payload = { "name": "John Doe" } 6 headers = { 7 "Authorization": "Bearer <token>", 8 "Content-Type": "application/json" 9 } 10 11 response = requests.post(url, json=payload, headers=headers) 12 13 print(response.json())

1 { 2 "id": "123e4567-e89b-12d3-a456-426614174000", 3 "name": "John Doe", 4 "slug": "john-doe", 5 "email": "john@example.com", 6 "imageUrl": "https://example.com/avatar.jpg", 7 "socialMedia": {}, 8 "scope": "private", 9 "isSelf": false, 10 "tokenCount": 1500, 11 "organizationId": "123e4567-e89b-12d3-a456-426614174001", 12 "createdAt": "2025-01-01T00:00:00.000Z", 13 "updatedAt": "2025-01-01T00:00:00.000Z", 14 "digitalTwins": [ 15 { 16 "id": "123e4567-e89b-12d3-a456-426614174002", 17 "name": "Default Twin", 18 "mindId": "123e4567-e89b-12d3-a456-426614174000", 19 "isDefault": true, 20 "createdAt": "2025-01-01T00:00:00.000Z", 21 "updatedAt": "2025-01-01T00:00:00.000Z", 22 "mindAssessments": [ 23 { 24 "id": "123e4567-e89b-12d3-a456-426614174003", 25 "mindId": "123e4567-e89b-12d3-a456-426614174000", 26 "artifactId": "123e4567-e89b-12d3-a456-426614174004", 27 "mindsetDate": "2025-01-01T00:00:00.000Z", 28 "status": "completed", 29 "startedAt": "2025-01-01T00:00:00.000Z", 30 "completedAt": "2025-01-01T00:00:00.000Z", 31 "createdAt": "2025-01-01T00:00:00.000Z", 32 "updatedAt": "2025-01-01T00:00:00.000Z", 33 "tokenCount": 1500, 34 "byteSize": 10000, 35 "psychometricCount": 10, 36 "keyTopicCount": 5, 37 "findingCount": 8 38 } 39 ], 40 "coreLastUpdatedAt": "2025-01-01T00:00:00.000Z" 41 } 42 ], 43 "mindCategories": [ 44 { 45 "id": "123e4567-e89b-12d3-a456-426614174005", 46 "name": "internal team", 47 "organizationId": "123e4567-e89b-12d3-a456-426614174001", 48 "createdAt": "2025-01-01T00:00:00.000Z", 49 "updatedAt": "2025-01-01T00:00:00.000Z" 50 } 51 ] 52 }

Creates a new mind

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

namestringRequired>=1 character

emailstringOptionalformat: "email"

imageUrlstringOptionalformat: "uri"

socialMediamap from strings to anyOptional

categoriesstringOptional

Comma-separated list of categories

Response

Successfully created mind

idstring

namestring

slugstring or null

emailstring or null

imageUrlstring or null

socialMediamap from strings to any or null

scopestring

isSelfboolean

tokenCountdouble or null

organizationIdstring or null

createdAtstring or nullformat: "date"

updatedAtstring or nullformat: "date"

digitalTwinslist of objects

Array of digital twins associated with this mind

mindCategorieslist of objects

Array of categories associated with this mind

Authentication

Request

Response

Errors