Set tags for a mind | Mind Reasoner API Documentation

curl -X PUT https://api.reasoner.com/api/mindsim/minds/123e4567-e89b-12d3-a456-426614174000/tags \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "tagNames": [
    "Marketing",
    "Product"
  ]
}'

{
  "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
  }
}

Replaces all tags for a specific mind with the provided tag list. Pass an empty array to remove all tags.

Authentication

AuthorizationBearer

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

Path parameters

mindIdstringRequired

Request

This endpoint expects an object.

tagNameslist of stringsRequired

Array of tag names to set for this mind. Replaces all existing tags.

Response

Successfully set tags

mindobject

Errors

400

Bad Request Error

404

Not Found Error

500

Internal Server Error

$	curl -X PUT https://api.reasoner.com/api/mindsim/minds/123e4567-e89b-12d3-a456-426614174000/tags \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"tagNames": [
>	"Marketing",
>	"Product"
>	]
>	}'

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	}