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 "mind": { 3 "id": "123e4567-e89b-12d3-a456-426614174000", 4 "name": "John Doe", 5 "slug": "john-doe", 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 }, 15 "digitalTwin": { 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 }, 23 "mindAssessments": [ 24 { 25 "id": "123e4567-e89b-12d3-a456-426614174003", 26 "mindId": "123e4567-e89b-12d3-a456-426614174000", 27 "artifactId": "123e4567-e89b-12d3-a456-426614174004", 28 "mindsetDate": "2025-01-01T00:00:00.000Z", 29 "status": "completed", 30 "startedAt": "2025-01-01T00:00:00.000Z", 31 "completedAt": "2025-01-01T00:00:00.000Z", 32 "createdAt": "2025-01-01T00:00:00.000Z", 33 "updatedAt": "2025-01-01T00:00:00.000Z", 34 "tokenCount": 1500, 35 "byteSize": 10000, 36 "psychometricCount": 10, 37 "keyTopicCount": 5, 38 "findingCount": 8 39 } 40 ], 41 "mindCategories": [ 42 { 43 "id": "123e4567-e89b-12d3-a456-426614174005", 44 "name": "internal team", 45 "organizationId": "123e4567-e89b-12d3-a456-426614174001", 46 "createdAt": "2025-01-01T00:00:00.000Z", 47 "updatedAt": "2025-01-01T00:00:00.000Z" 48 } 49 ] 50 }

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

mindobject

digitalTwinobject

mindAssessmentslist of objects

mindCategorieslist of objects

Authentication

Request

Response

Errors