Tags Resource

Tags

Tags are used to categorize and filter Minds within your organization.

List Tags

Retrieve all tags currently in use.

1const tags = await mindsim.tags.list();

Parameters

None.

Response

Returns an array of Tag objects.

1[
2 {
3 "id": "47a09167-3b9f-442c-a19c-96398cf238fb",
4 "name": "hero",
5 "mindCount": 5
6 },
7 {
8 "id": "a1ca5e66-6f3a-4d92-ab25-8a86fdb111c1",
9 "name": "villain",
10 "mindCount": 2
11 }
12]

Update a Tag

Renaming a tag updates it across all Minds that use it.

1const updatedTag = await mindsim.tags.update("tag-id-uuid", {
2 name: "senior-developer"
3});

Parameters

ParameterTypeRequiredDescription
tagIdstringYesThe ID of the tag to update.
data.namestringYesThe new name for the tag.

Response

Returns the updated Tag object.


Delete a Tag

Deletes the tag definition. This removes the tag from all Minds, but does not delete the Minds themselves.

1await mindsim.tags.delete("tag-id-uuid");

Parameters

ParameterTypeRequiredDescription
tagIdstringYesThe ID of the tag to delete.

Response

1{
2 "deleted": true
3}