---
title: "PUT /api/v1/projects/{projectId}/audit-log-settings"
method: PUT
path: "/api/v1/projects/{projectId}/audit-log-settings"
tags: ["Audit Logs"]
---

# PUT /api/v1/projects/{projectId}/audit-log-settings

`PUT /api/v1/projects/{projectId}/audit-log-settings`

## Request

- Base URL: `https://us.infisical.com`
- URL: `https://us.infisical.com/api/v1/projects/{projectId}/audit-log-settings`
- Auth: none declared

Update which audit log event classes the project records. Requires the project admin role.

## Path parameters

- `projectId` string, uuid, required

## Request body

- object
  - `eventClasses` object[], required: Every event class except management and data-access, each exactly once. The request replaces the current settings. Management and data-access events are always recorded, so a request that includes either class is rejected. The authorization class can only be turned on for organizations on the new privilege system; otherwise the request is rejected.
    - `eventClass` 'management' | 'authentication' | 'authorization' | 'data-access', required: The audit log event class: management, authentication, data-access, or authorization.
    - `isEnabled` boolean, required: Whether to record events of this class for the project. A project that has never saved a setting uses the default.

## Response `200`

Default Response

- object
  - `auditLogSettings` object, required
    - `eventClasses` object[], required
      - `eventClass` 'management' | 'authentication' | 'authorization' | 'data-access', required: The audit log event class: management, authentication, data-access, or authorization.
      - `isEnabled` boolean, required: Whether events of this class are recorded.
    - `shouldUseNewPrivilegeSystem` boolean, required: Whether the organization is on the new privilege system. Permission denials (the authorization class) are only recorded on the new privilege system.

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `422`: Default Response
- `500`: Default Response

## Changes

- **2026-10-07** `8378abf16138`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/infisical/apis/infisical-api/changes/api/v1/projects/:projectId/audit-log-settings/put.md)

---

[API](https://skmtc.dev/infisical/apis/infisical-api.md) - [All operations](https://skmtc.dev/infisical/apis/infisical-api/llms.txt) - [OpenAPI document](https://skmtc.dev/infisical/apis/infisical-api/revisions/7f940199c899?raw)