---
title: "Update Project Settings"
method: PUT
path: "/projects/{project_id}/settings"
tags: ["project_settings"]
---

# Update Project Settings

`PUT /projects/{project_id}/settings`

## Path parameters

- `project_id` string, uuid4, required

## Request body

- GenAIProjectSettings
  - `metric_weights_configuration` object, nullable
  - `alerts_configuration` AlertsConfiguration
    - `emails` string[]
    - `webhooks` Webhook[]
      - `url` string, uri, required
      - `status` 'active' | 'untested' | 'failed' | 'paused'
      - `notes` string

## Response `200`

Successful Response

- ProjectSettingsDB
  - `metric_weights_configuration` object, nullable
  - `alerts_configuration` AlertsConfiguration
    - `emails` string[]
    - `webhooks` Webhook[]
      - `url` string, uri, required
      - `status` 'active' | 'untested' | 'failed' | 'paused'
      - `notes` string
  - `project_id` string, uuid4, required
  - `id` string, uuid4, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-13** `344acdc36dbb` — 1 breaking, 6 warning, 1 info
  - removed the enum value `Measures which documents or chunks retrieved were used by the model to generate a response, and how much of the text in the retrieved chunks was used by the model to compose its response.` of the request property `metric_weights_configuration/anyOf[subschema #1]/additionalProperties/description/anyOf[subschema #1: MetricDescriptions]/`
  - removed the request property `scorers_config`
  - removed the optional property `customized_scorers_configuration` from the response with the `200` status
  - removed the optional property `generated_scorers_configuration` from the response with the `200` status
  - …4 more
- …earlier changes not shown

[Full history](https://skmtc.dev/galileo/apis/galileo-api-server/changes/projects/:project_id/settings/put.md)

---

[API](https://skmtc.dev/galileo/apis/galileo-api-server.md) · [All operations](https://skmtc.dev/galileo/apis/galileo-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/galileo/galileo-api-server/revisions/8b1d1a4a933e/schema)