List team audit log

GET

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

curl --request GET \
  --url https://hitkeep.com/api/user/teams/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/audit \
  --cookie hk_token=<hk_token>

Lists recent audit events for team management actions.

Authorizations

• cookieAuth

Parameters

Path Parameters

id

required

string format: uuid

Query Parameters

action

string

Optional exact audit action to filter by.

outcome

string

Optional exact audit outcome to filter by.

target_type

string

Optional exact audit target type to filter by.

query

string

Searches actor, target, details, IP, country, and request ID fields.

from

string format: date-time

Inclusive RFC3339 start timestamp.

to

string format: date-time

Inclusive RFC3339 end timestamp.

limit

integer

>= 1 <= 200

Maximum number of audit rows to return (default 25, max 200).

offset

integer

Zero-based audit row offset for pagination.

Responses

200

Team audit entries

Media type application/json

object

action

string

entries

Array<object>

object

action

string

actor_email

string format: email

actor_email_snapshot

string

actor_role_snapshot

string

actor_user_id

string format: uuid

created_at

string format: date-time

details

string

id

string format: uuid

ip_address

string

ip_country_code

string

outcome

string

request_id

string

target_email

string format: email

target_id

string

target_label

string

target_type

string

target_user_id

string format: uuid

team_id

string format: uuid

user_agent

string

has_more

boolean

limit

integer

offset

integer

total

integer

Example ^generated

{
  "action": "example",
  "entries": [
    {
      "action": "example",
      "actor_email": "hello@example.com",
      "actor_email_snapshot": "example",
      "actor_role_snapshot": "example",
      "actor_user_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "created_at": "2026-04-15T12:00:00Z",
      "details": "example",
      "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "ip_address": "example",
      "ip_country_code": "example",
      "outcome": "example",
      "request_id": "example",
      "target_email": "hello@example.com",
      "target_id": "example",
      "target_label": "example",
      "target_type": "example",
      "target_user_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "team_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "user_agent": "example"
    }
  ],
  "has_more": true,
  "limit": 1,
  "offset": 1,
  "total": 1
}

400

Invalid query parameters

Media type application/json

object

message

string

Example ^generated

{
  "message": "example"
}

403

Access denied

Media type application/json

object

message

string

Example ^generated

{
  "message": "example"
}