Implications

Implications automatically apply related tags when you tag an item. They’re applied at write-time, not query-time, which makes searches fast.

How Implications Work

When you create an implication A → B:

Any time someone adds tag A to an item, tag B is automatically added
All existing items with tag A are immediately updated to include tag B
Implications can chain: dog → canine → mammal → animal

Example: If you have dog → canine → animal, tagging something with “dog” automatically applies all three tags.

Implication Object

{
  "id": "impl-123",
  "application_id": "app-123",
  "from_tag_id": "tag-dog",
  "to_tag_id": "tag-canine",
  "created_at": "2024-01-15T10:30:00Z",
  "from_tag": {
    "id": "tag-dog",
    "name": "dog"
  },
  "to_tag": {
    "id": "tag-canine",
    "name": "canine"
  }
}

Field	Type	Description
`from_tag_id`	UUID	Source tag (when this is added…)
`to_tag_id`	UUID	Target tag (…this is auto-added)
`from_tag`	object	Expanded source tag details
`to_tag`	object	Expanded target tag details

Endpoints

Create Implication

POST /api/v1/applications/{app_id}/implications

Create a new implication rule.

Request:

{
  "from_tag_id": "tag-dog",
  "to_tag_id": "tag-canine"
}

Example:

curl -X POST "https://api.taguten.com/api/v1/applications/{app_id}/implications" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_tag_id": "tag-dog",
    "to_tag_id": "tag-canine"
  }'

List Implications

GET /api/v1/applications/{app_id}/implications

Get all implication rules in your application.

curl "https://api.taguten.com/api/v1/applications/{app_id}/implications" \
  -H "Authorization: Bearer YOUR_API_KEY"

Delete Implication

DELETE /api/v1/applications/{app_id}/implications/{implication_id}

Delete an implication rule. This automatically removes the implied tags from items where they were added by this implication.

curl -X DELETE "https://api.taguten.com/api/v1/applications/{app_id}/implications/{impl_id}" \
  -H "Authorization: Bearer YOUR_API_KEY"

Common Use Cases

Taxonomies

dog → canine → mammal → animal
cat → feline → mammal → animal
fox → canine → mammal → animal

Content Ratings

explicit → nsfw
questionable → nsfw

Genre Hierarchies

rock music → music
jazz → music
electronic → music