---
title: "List team audit log"
method: GET
path: "/api/user/teams/{id}/audit"
tags: ["Teams"]
---

# List team audit log

`GET /api/user/teams/{id}/audit`

## Request

- Base URL: `https://demo.hitkeep.com`
- URL: `https://demo.hitkeep.com/api/user/teams/{id}/audit`
- Auth: API key in cookie `hk_token`

Lists recent audit events for team management actions.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `action` string
- `outcome` string
- `target_type` string
- `query` string
- `from` string, date-time
- `to` string, date-time
- `limit` integer
- `offset` integer

## Response `200`

Team audit entries

- TeamAuditListResponse
  - `action` string
  - `entries` TeamAuditEntry[]
    - `action` string
    - `actor_email` string, email
    - `actor_email_snapshot` string
    - `actor_role_snapshot` string
    - `actor_user_id` string, uuid
    - `created_at` string, date-time
    - `details` string
    - `id` string, uuid
    - `ip_address` string
    - `ip_country_code` string
    - `outcome` string
    - `request_id` string
    - `target_email` string, email
    - `target_id` string
    - `target_label` string
    - `target_type` string
    - `target_user_id` string, uuid
    - `team_id` string, uuid
    - `user_agent` string
  - `has_more` boolean
  - `limit` integer
  - `offset` integer
  - `total` integer

## Other responses

- `400`: Invalid query parameters
- `403`: Access denied

---

[API](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api.md) · [All operations](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api/revisions/bb2df36ab2a4?raw)