Audit Log

Every mutation in Thogits is recorded in an immutable audit log. You can query it to see the history of changes to thogits and tags, filtered by time range, entity, or event type.

Event Types

Event Type	Description
`thogit_created`	A thogit was created
`thogit_updated`	A thogit’s name or description was updated
`thogit_deleted`	A thogit was soft-deleted
`tag_created`	A tag schema was created
`tag_updated`	A tag schema was updated
`tag_deleted`	A tag was soft-deleted
`tag_applied`	A tag was applied to a thogit
`tag_removed`	A tag was removed from a thogit
`tag_values_updated`	Field values for a tag on a thogit were updated

POST /audit-log/search

Query the audit log with optional filters.

Auth required: Yes

Request body:

Field	Type	Required	Description
`limit`	integer	No	Maximum number of events to return
`after`	string	No	ISO 8601 datetime — only events after this time
`before`	string	No	ISO 8601 datetime — only events before this time
`thogit_ids`	array	No	Filter to events involving these thogit ULIDs
`tag_ids`	array	No	Filter to events involving these tag ULIDs
`event_types`	array	No	Filter to specific event types

All filters are optional. Omit the body or pass {} to get the most recent events.

# Get the last 10 events
curl -X POST https://app.thogits.com/api/audit-log/search \
  -H "Content-Type: application/json" \
  -b cookies.txt -c cookies.txt \
  -d '{"limit": 10}'

# Get tag-related events for a specific thogit
curl -X POST https://app.thogits.com/api/audit-log/search \
  -H "Content-Type: application/json" \
  -b cookies.txt -c cookies.txt \
  -d '{
    "thogit_ids": ["01HQ4M8R3ZBNWY6K9J2X5V7Q0A"],
    "event_types": ["tag_applied", "tag_removed", "tag_values_updated"]
  }'

# Get events within a time range
curl -X POST https://app.thogits.com/api/audit-log/search \
  -H "Content-Type: application/json" \
  -b cookies.txt -c cookies.txt \
  -d '{
    "after": "2025-01-15T00:00:00Z",
    "before": "2025-01-16T00:00:00Z"
  }'

Response (200):

[
  {
    "event_id": "01HQ7X3A4BCDEFGHIJ5KLMNO6P",
    "event_type": "tag_applied",
    "entity_type": "thogit",
    "thogit_id": "01HQ4M8R3ZBNWY6K9J2X5V7Q0A",
    "tag_id": "01HQ3K5P7YGXJV8N2M4W6R0T1S",
    "details": {
      "tag_name": "Task",
      "field_values": {"status": "Todo", "priority": "high"}
    },
    "created_at": "2025-01-15T14:22:00Z"
  },
  {
    "event_id": "01HQ7X2Z3ABCDEFGHI4JKLMN5O",
    "event_type": "thogit_created",
    "entity_type": "thogit",
    "thogit_id": "01HQ4M8R3ZBNWY6K9J2X5V7Q0A",
    "tag_id": null,
    "details": {
      "name": "Learn Rust ownership"
    },
    "created_at": "2025-01-15T14:20:00Z"
  }
]