Audit Log

Review your account's audit log: a record of who did what and when. This is a read-only endpoint, authenticated with a Bearer JWT (see Authentication).

Endpoints

Method	Path	Description
GET	/api/v1/audit	List audit-log entries for your account

List audit entries

GET /api/v1/audit

Parameter	Type	Default	Description
action	string	—	Filter by action (for example create, update)
resource_type	string	—	Filter by resource type (for example api_key, user)
page	int	1	Page number
page_size	int	—	Items per page

curl "https://api.haltless.io/api/v1/audit?resource_type=api_key&page_size=10" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "items": [
    {
      "id": "...",
      "tenant_id": "...",
      "user_id": "USER_UUID",
      "user_full_name": "Jane Doe",
      "user_email": "jane@example.com",
      "action": "create",
      "resource_type": "api_key",
      "resource_id": "...",
      "details": { "name": "edge-agent-prod" },
      "ip_address": "203.0.113.10",
      "created_at": "2026-08-05T10:00:00Z"
    }
  ],
  "pagination": { "total": 1, "page": 1, "page_size": 10 }
}

Each entry records the actor (user_id, user_full_name, user_email), the action taken, the resource_type and resource_id affected, any structured details, the originating ip_address, and the created_at timestamp. Results are scoped to your own account.