tags-and-properties

Domino Tags and Properties Skill

Description

This skill covers Domino's Taxonomy API, which manages two complementary metadata systems for organizing entities (projects, models, datasets, apps, project templates, NetApp volumes):

• Tags — hierarchical labels grouped into namespaces. An entity either has a tag or it doesn't.
• Properties — typed metadata fields (text, number, date, select, …), each holding a value per entity.

It documents every public endpoint with curl examples that work today against a Domino cluster where the taxonomy service is enabled. Properties are covered in depth in PROPERTIES.md (definitions) and PROPERTY-VALUES.md (per-entity values).

Activation

Activate this skill when the user wants to:

• Tag a project, model, dataset, app, project template, or NetApp volume
• Find all entities that share a tag, or query by multiple tags
• Build a hierarchical taxonomy (namespaces with nested tags)
• Bulk-tag entities during onboarding
• Migrate a taxonomy tree across Domino environments (CSV export/import)
• Merge duplicate tags
• Tune autocomplete results in a tagging UI
• Define typed metadata fields (properties) — e.g. a Budget number, a Review Date, an Owner user, or a Status single-select
• Set, read, or clear property values on an entity (incl. versioned entities like model_version / app_version)
• Group properties or manage property definitions across a deployment

Configuration

Auth via the local access-token endpoint per the Skill Authoring Standards. Never use DOMINO_USER_API_KEY.

TOKEN=$(curl -s http://localhost:8899/access-token)
# Taxonomy is served through the Domino API host gateway.
BASE="$DOMINO_API_HOST/api/taxonomy/v1"
H="Authorization: Bearer $TOKEN"

Key Concepts

Concept	Description
Namespace	Top-level group for tags (e.g. Indication, Analysis). Has label, optional description, and allowMultipleAssignments flag.
Tag	A label inside a namespace. Can be hierarchical via parentId (e.g. Clinical_Data / SDTM). Has label, namespaceId, optional description and parentId, and status (active / inactive).
Property	A typed metadata field — has a label, a type (text, number, date, boolean, url, user, organization, user_or_org, select, multi_select), a set of allowedEntities, an optional groupName, and (for select types) allowedValues. See PROPERTIES.md.
Property value	The typed value a property holds for one specific entity, set via PATCH /property-values. See PROPERTY-VALUES.md.
Property group	Free-form groupName string that buckets properties in the values view; ungrouped properties fall under Miscellaneous.
EntityType	Enum over entities. Tags apply to dataset, project, project_template, model, app, netapp_volume. Properties additionally support the versioned types model_version and app_version.
allowMultipleAssignments	(Tags) When true, an entity can hold multiple tags from the same namespace. When false, applying a new tag from the namespace replaces any existing one.
Taxonomy tree	The full nested view: namespaces → root tags → child tags. Returned by GET /taxonomy.
Limits	GET /config returns maxDepth (max tag nesting), maxLabelLength (max characters per label), maxSelectAllowedValuesCount (max options on a select property), and maxSelectAllowedValueLength (max length of one option).