# Get settings in project

`GET /v1/projects/{project}/settings`, operation `settings.GetSettingsInProject`

Gets the settings of an organization or a project: each section of them that the caller may read.

Each section is as its own Get gives it, and is left out unless the caller holds its get permission, such as llmgateway.settings.get for the LLM gateway's. A caller who may read none is refused, as for any resource they may not see. To change a section, read it alone, for its ETag.

## Parameters

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

## Responses

### 200

OK

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `auditLog` | `AuditLogSettings` | No |  |
| `auditLog.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. |
| `auditLog.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. |
| `auditLog.effective` | `EffectiveAuditLogSettings` | Yes | What applies here, and where each setting's value comes from. |
| `auditLog.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. |
| `auditLog.name` | `string` | Yes | Resource name, organizations/{organization_id}/settings/auditLog or projects/{project_id}/settings/auditLog. |
| `auditLog.updateTime` | `string (date-time)` | No | When the settings set here last changed; absent if they never did. |
| `llmGateway` | `LlmGatewaySettings` | No |  |
| `llmGateway.effective` | `EffectiveLlmGatewaySettings` | Yes | What applies to requests here, and where each setting's value comes from. |
| `llmGateway.inherited` | `EffectiveLlmGatewaySettings` | Yes | What the level above makes apply, which a setting unset here takes: for a project, its organization's effective settings; for an organization, kosem's defaults. |
| `llmGateway.monthlySpendLimit` | `Money` | No | The most that requests here may cost in a calendar month (UTC), in US dollars; absent while unset, which is no limit. An organization's limit counts all of its projects, and a project's only itself. Once a limit is reached, the gateway refuses requests until the month ends; requests already running may go a little past it. Only models whose prices kosem knows count. |
| `llmGateway.name` | `string` | Yes | Resource name, organizations/{organization_id}/settings/llmGateway or projects/{project_id}/settings/llmGateway. |
| `llmGateway.updateTime` | `string (date-time)` | No | When the settings set here last changed; absent if they never did. |
| `name` | `string` | Yes | Resource name, organizations/{organization_id}/settings or projects/{project_id}/settings. |

### 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.