How do tags work?

Senso auto-tags on creation: raw content, uploaded files once ingestion finishes, prompts, and search queries as they arrive. The tag library grows on its own, so most callers never manage it directly.

Setting tags on a document replaces whatever was on it. Unknown tag names are created automatically. Tags apply to documents, not folders.

bash

curl -X POST https://apiv2.senso.ai/api/v1/org/kb/nodes/$NODE_ID/tags \
  -H "X-API-Key: $SENSO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"names": ["refunds"]}'

Call it

GET/org/kb/nodes/{id}/tagsOpen in API reference →The tags on a node.

PUT/org/kb/nodes/{id}/tagsOpen in API reference →Replace the whole set.

POST/org/kb/nodes/{id}/tagsOpen in API reference →Add by name or by id.

DELETE/org/kb/nodes/{id}/tagsOpen in API reference →Clear them.