Audit Logs

Audit logs provide a complete record of all activity in your organization.

What's Logged

Category	Events
Auth	Login, logout, MFA changes
Members	Invite, role change, removal
Projects	Create, update, delete
Comments	Add, resolve, delete
Settings	Any configuration change
API	API key creation, usage

Viewing Logs

1. Go to Settings → Audit Logs
2. Filter by date, user, or event type
3. Click event for details

Log Entry Format

{
  "id": "log_abc123",
  "timestamp": "2024-12-24T12:00:00Z",
  "actor": {
    "id": "usr_xyz",
    "email": "[email protected]"
  },
  "action": "comment.created",
  "resource": {
    "type": "comment",
    "id": "cmt_123"
  },
  "metadata": {
    "ip": "192.168.1.1",
    "userAgent": "Mozilla/5.0..."
  }
}

Filtering

Filter logs by:

• Date range: Last 7/30/90 days or custom
• Actor: Specific user
• Action: Event type
• Resource: Project, comment, etc.

Exporting Logs

Export for compliance:

1. Set filters
2. Click Export
3. Choose format (CSV, JSON)
4. Download

Retention

Plan	Retention
Free	7 days
Pro	30 days
Business	90 days
Enterprise	1 year+

API Access

Query logs programmatically:

GET /v1/audit-logs?
  from=2024-12-01&
  to=2024-12-24&
  action=comment.created

SIEM Integration

Enterprise plans can forward logs to:

• Splunk
• Datadog
• Elastic
• Custom webhook

Contact support to configure.