Skip to main content
GET
/
api
/
v1
/
audit-log
List Audit Log Events
curl --request GET \
  --url https://ah-api.merge.dev/api/v1/audit-log \
  --header 'Authorization: Bearer <token>'
{
  "count": 123,
  "next": "https://ah-api.merge.dev/api/v1/audit-log?page=4",
  "previous": "https://ah-api.merge.dev/api/v1/audit-log?page=2",
  "results": [
    {
      "id": "b5ceea2a-7171-47ce-8090-165cfce5572c",
      "user_name": "Gil Feig",
      "user_email": "hello@merge.dev",
      "role": "Admin",
      "ip_address": "192.0.2.123",
      "event_type": "TOOL_PACK_CREATED",
      "event_description": "Created tool pack 'Customer Support Pack'",
      "created_at": "2024-01-15T10:30:00Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Token-based authentication with required prefix "Bearer"

Query Parameters

​
created_after
string<date-time>

Filter events created on or after this date (ISO 8601)

​
created_before
string<date-time>

Filter events created on or before this date (ISO 8601)

​
event_type
enum<string>

Filter by event type

Available options:
BILLING_PAYMENT_METHOD_ADDED,
BILLING_PAYMENT_METHOD_UPDATED,
BILLING_SUBSCRIPTION_CANCELLED,
CHAT_SESSION_CREATED,
CHAT_SESSION_ENDED,
CONNECTOR_DELETED,
CONNECTOR_IMPORTED,
CONNECTOR_UPDATED,
CREDENTIAL_DELETED,
DEFAULT_RESOURCES_CREATED,
GIT_SETTINGS_CREATED,
GIT_SETTINGS_DELETED,
GIT_SETTINGS_UPDATED,
INBOUND_WEBHOOK_SETTINGS_UPDATED,
LOGIN_FAILED,
OUTBOUND_WEBHOOK_CREATED,
OUTBOUND_WEBHOOK_DELETED,
OUTBOUND_WEBHOOK_UPDATED,
OUTBOUND_WEBHOOK_VERIFICATION_KEY_REFRESHED,
PRODUCTION_API_KEY_REGENERATED,
REGISTERED_USER_CREATED,
REGISTERED_USER_DELETED,
ROLE_CREATED,
ROLE_DELETED,
ROLE_UPDATED,
SECURITY_RULE_CREATED,
SECURITY_RULE_DELETED,
SECURITY_RULE_UPDATED,
SSO_LOGIN_NOT_REQUIRED,
SSO_LOGIN_REQUIRED,
SSO_LOGIN_REQUIRED_OFF,
SSO_LOGIN_REQUIRED_ON,
SSO_PROVIDER_CREATED,
SSO_PROVIDER_DELETED,
SSO_PROVIDER_UPDATED,
TEST_API_KEY_CREATED,
TEST_API_KEY_DELETED,
TOOL_PACK_CREATED,
TOOL_PACK_DELETED,
TOOL_PACK_UPDATED,
USER_CREATED,
USER_INVITATION_ACCEPTED,
USER_INVITATION_CANCELLED,
USER_INVITED,
USER_PASSWORD_RESET,
USER_UPDATED
​
page
integer

A page number within the paginated result set.

​
page_size
integer

Number of results to return per page.

​
user_id
string<uuid>

Filter by user ID

Response

200 - application/json
​
count
integer
required
Example:

123

​
results
object[]
required
​
next
string<uri> | null
Example:

"https://ah-api.merge.dev?page=4"

​
previous
string<uri> | null
Example:

"https://ah-api.merge.dev?page=2"