Thogit Tags

These endpoints manage the relationship between thogits and tags — applying tags, updating field values, and removing tags. For creating or modifying tag schemas themselves, see Tags.

POST /thogits/{thogit_id}/tags

Apply a tag to a thogit with initial field values.

Auth required: Yes

Request body:

Field	Type	Required	Description
tag	object	Yes	Tag application object
tag.tag_ref	object	Yes	Either {"New": {"name": "...", "fields": {...}}} or {"Existing": "TAG_ULID"}
tag.field_values	object	No	Initial field values matching the tag schema

curl -X POST https://app.thogits.com/api/thogits/01HQ4M8R3ZBNWY6K9J2X5V7Q0A/tags \
  -H "Content-Type: application/json" \
  -b cookies.txt -c cookies.txt \
  -d '{
    "tag": {
      "tag_ref": {"Existing": "01HQ3K5P7YGXJV8N2M4W6R0T1S"},
      "field_values": {"status": "Todo", "priority": "high"}
    }
  }'

Response (200):

{
  "tag_id": "01HQ3K5P7YGXJV8N2M4W6R0T1S"
}

Errors:

Status	Cause
404	Thogit or tag not found
409	Tag is already applied to this thogit

Note

A tag can only be applied once to a given thogit. If you need to update the field values of an already-applied tag, use the PUT endpoint below.

---

PUT /thogits/{thogit_id}/tags/{tag_id}

Update the field values of a tag that is already applied to a thogit.

Auth required: Yes

Request body:

Field	Type	Required	Description
field_values	object	Yes	New field values
merge	boolean	No	If true, merge with existing values. If false (default), replace all values.

Merge Behavior

The merge flag controls how field values are updated:

merge: false (default)

Replaces all field values. Any fields not included in the request are removed.

# Existing values: {"status": "Todo", "priority": "high", "due_date": "2025-06-01"}
curl -X PUT https://app.thogits.com/api/thogits/01HQ4M8R3ZBNWY6K9J2X5V7Q0A/tags/01HQ3K5P7YGXJV8N2M4W6R0T1S \
  -H "Content-Type: application/json" \
  -b cookies.txt -c cookies.txt \
  -d '{"field_values": {"status": "Done"}, "merge": false}'
# Result: {"status": "Done"} — priority and due_date are gone

merge: true

Merges with existing values. Only the specified fields are updated; unmentioned fields are preserved.

# Existing values: {"status": "Todo", "priority": "high", "due_date": "2025-06-01"}
curl -X PUT https://app.thogits.com/api/thogits/01HQ4M8R3ZBNWY6K9J2X5V7Q0A/tags/01HQ3K5P7YGXJV8N2M4W6R0T1S \
  -H "Content-Type: application/json" \
  -b cookies.txt -c cookies.txt \
  -d '{"field_values": {"status": "Done"}, "merge": true}'
# Result: {"status": "Done", "priority": "high", "due_date": "2025-06-01"}

Tip

Use merge: true for partial updates — such as changing a single field without affecting the rest. Use merge: false (or omit it) when you want to set the complete field state.

Response (200): The updated thogit object.

Errors:

Status	Cause
404	Thogit not found, or tag is not applied to this thogit

---

DELETE /thogits/{thogit_id}/tags/{tag_id}

Remove a tag from a thogit. This deletes all field values associated with that tag on the thogit.

Auth required: Yes

curl -X DELETE https://app.thogits.com/api/thogits/01HQ4M8R3ZBNWY6K9J2X5V7Q0A/tags/01HQ3K5P7YGXJV8N2M4W6R0T1S \
  -b cookies.txt -c cookies.txt

Response (200): The updated thogit object (without the removed tag).

Errors:

Status	Cause
404	Thogit or tag not found