Skip to main content

Module tag

Module tag 

Source
Expand description

Tag diff types and registry comparison.

Tags are GitOps-only: Braze has no public REST API for managing them. diff compares the local registry (tags/registry.yaml) against the union of tag names referenced on local resources (content_blocks, email_templates) and reports the symmetric drift:

  • ReferencedButUnregistered: a resource references this tag but it is not declared in the registry. Apply would fail at the Braze API layer with 400 Tags could not be found. This is actionable for the operator (add to registry + create in Braze dashboard) and blocks apply pre-flight.
  • RegisteredButUnreferenced: declared in the registry but no resource currently uses it. Informational — may be a deletion the operator hasn’t pruned, or a tag staged for upcoming use.
  • Unchanged: declared and referenced, in sync.

apply cannot mutate tags directly, so no diff variant is “actionable” in the apply-mutation sense. The diff is consumed by validate and by apply’s pre-flight check.

Structs§

TagDiff

Enums§

TagOp

Functions§

diff
Compare a local registry against a set of tag names actually referenced by local resources.