Create a new mind | Mind Reasoner API Documentation

curl -X POST https://api.reasoner.com/api/mindsim/minds \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "John Doe"
}'

{
  "mind": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "John Doe",
    "slug": "john-doe",
    "email": "john@example.com",
    "imageUrl": "https://example.com/avatar.jpg",
    "socialMedia": {},
    "scope": "private",
    "isSelf": false,
    "organizationId": "123e4567-e89b-12d3-a456-426614174001",
    "createdAt": "2025-01-01T00:00:00.000Z",
    "updatedAt": "2025-01-01T00:00:00.000Z",
    "tags": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174005",
        "name": "internal team",
        "organizationId": "123e4567-e89b-12d3-a456-426614174001",
        "createdAt": "2025-01-01T00:00:00.000Z",
        "updatedAt": "2025-01-01T00:00:00.000Z"
      }
    ],
    "snapshotCount": 1,
    "psychometricCount": 10,
    "keyTopicCount": 5,
    "findingCount": 8
  }
}

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

tagsstringOptional

Comma-separated list of tags

Response

Successfully created mind

mindobject

Errors

400

Bad Request Error

$	curl -X POST https://api.reasoner.com/api/mindsim/minds \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "John Doe"
>	}'

1	{
2	"mind": {
3	"id": "123e4567-e89b-12d3-a456-426614174000",
4	"name": "John Doe",
5	"slug": "john-doe",
6	"email": "john@example.com",
7	"imageUrl": "https://example.com/avatar.jpg",
8	"socialMedia": {},
9	"scope": "private",
10	"isSelf": false,
11	"organizationId": "123e4567-e89b-12d3-a456-426614174001",
12	"createdAt": "2025-01-01T00:00:00.000Z",
13	"updatedAt": "2025-01-01T00:00:00.000Z",
14	"tags": [
15	{
16	"id": "123e4567-e89b-12d3-a456-426614174005",
17	"name": "internal team",
18	"organizationId": "123e4567-e89b-12d3-a456-426614174001",
19	"createdAt": "2025-01-01T00:00:00.000Z",
20	"updatedAt": "2025-01-01T00:00:00.000Z"
21	}
22	],
23	"snapshotCount": 1,
24	"psychometricCount": 10,
25	"keyTopicCount": 5,
26	"findingCount": 8
27	}
28	}