# Get audit log settings in organization

`GET /v1/organizations/{organization}/settings/auditLog`, operation `auditLogSettings.GetAuditLogSettingsInOrganization`

Gets the audit log settings of an organization or a project.

The settings set at this level, of which those unset are absent; what applies, in `effective`, with where each value comes from; and what the level above makes apply, in `inherited`, which a setting unset here takes. The ETag header is the settings' revision.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `organization` | path | Yes | `string` | The organization's ID. |

## Responses

### 200

OK

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `dataAccess` | `DataAccessConfig[]` | No | Which calls Data Access records, by service, as set here, besides what the level above records; absent while unset, which adds nothing to it. Reads of audit logs are recorded whatever it says. |
| `dataAccessRetentionDays` | `integer (int32)` | No | How many days Data Access entries are kept, those of the organization's projects included; absent while unset, which keeps them 30 days. Organizations only. |
| `effective` | `EffectiveAuditLogSettings` | Yes | What applies here, and where each setting's value comes from. |
| `effective.dataAccess` | `EffectiveDataAccessConfig[]` | Yes | Which calls Data Access records, by service, in order: what the organization records and what the project adds, joined; none where neither records anything. A call is recorded when its service's types or allServices' include its own. |
| `effective.dataAccessRetentionDays` | `EffectiveInt32` | Yes | How many days Data Access entries are kept: the organization's retention, or kosem's 30, for its projects' entries too. |
| `inherited` | `EffectiveAuditLogSettings` | Yes | What the level above makes apply, which this level adds to and cannot turn off: for a project, its organization's effective settings; for an organization, kosem's defaults, which record nothing and keep Data Access entries 30 days. |
| `inherited.dataAccess` | `EffectiveDataAccessConfig[]` | Yes | Which calls Data Access records, by service, in order: what the organization records and what the project adds, joined; none where neither records anything. A call is recorded when its service's types or allServices' include its own. |
| `inherited.dataAccessRetentionDays` | `EffectiveInt32` | Yes | How many days Data Access entries are kept: the organization's retention, or kosem's 30, for its projects' entries too. |
| `name` | `string` | Yes | Resource name, organizations/{organization_id}/settings/auditLog or projects/{project_id}/settings/auditLog. |
| `updateTime` | `string (date-time)` | No | When the settings set here last changed; absent if they never did. |

### default

Error

Base URL: `https://api.kosem.ai`. See [API conventions](https://docs.kosem.ai/reference/api-conventions.md) for authentication, pagination and errors, and [https://docs.kosem.ai/openapi.yaml](https://docs.kosem.ai/openapi.yaml) for the full OpenAPI document.