Overview
Tags are predefined classification labels applied to articles and requirements. They enable cross-framework filtering by topic — for example, finding all content related to "data-breach" across GDPR, NIS2, and the CRA.
Methods
list()
Returns a page of all tags.
Parameters
| Parameter | Type | Default | Description |
|---|
page | int | 1 | Page number |
per_page | int | 20 | Items per page (1–100) |
Returns Page[Tag]
get()
Fetch a single tag by its slug.
Parameters
| Parameter | Type | Description |
|---|
slug | str | Tag slug, e.g. "data-breach" |
Returns Tag
iter()
Iterate over all tags.
Returns Iterator[Tag]
Model
Tag
| Field | Type | Description |
|---|
id | int | Internal numeric ID |
slug | str | URL-safe identifier, e.g. "data-breach" |
name | str | Human-readable label |
description | str | None | What this tag covers |
keywords | list[str] | Keywords used to auto-tag content |
color | str | None | Hex color code for UI display |
created_at | str | ISO 8601 creation timestamp |
Examples
Look up a tag’s keywords
Find all articles tagged with a given label
Build a tag index across all frameworks
Tag slugs are stable — safe to hardcode in application logic or store in databases as foreign keys.