Skip to navigation

Tags Resource

Tags

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

List Tags

Retrieve all tags currently in use.

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

Parameters

None.

Response

Returns an array of Tag objects.

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

Update a Tag

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

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

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.

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

Parameters

ParameterTypeRequiredDescription
tagIdstringYesThe ID of the tag to delete.

Response

{
"deleted": true
}