---
title: "Update system"
method: PATCH
path: "/systems/{systemId}"
---

# Update system

`PATCH /systems/{systemId}`

Update an existing system. Only the fields provided in the request body will be updated.
If a field is provided, the new content will replace the existing content.
If a field is not provided, the existing content will remain unchanged.

## Path parameters

- `systemId` string, uuid, required

## Request body

- object
  - `name` string — The name of the system. Unique within the project.
  - `description` string — The description of the system.
  - `productionVersionId` string, uuid — The ID of the production version of the system.

## Response `200`

System updated successfully

- System — A System Under Test (SUT). Systems are templates - to run evaluations, pair them with a SystemVersion that provides specific parameter values.
  - `id` string, uuid, required — The ID of the system.
  - `name` string, required — The name of the system. Unique within the project.
  - `description` string, required — The description of the system.
  - `productionVersion` SystemVersion, required — A SystemVersion defines the specific settings for a System Under Test. System versions contain parameter values that determine system behavior during evaluation. They are immutable snapshots - once created, they never change. When running evaluations, you reference a specific systemVersionId to establish which system version to test.
    - `id` string, uuid, required — The ID of the system version.
    - `systemId` string, uuid, required — The ID of the system the system version belongs to.
    - `name` string, required — The name of the system version.
    - `config` object, required — The configuration of the system version.
  - `versions` object[], required — The versions of the system.
    - `id` string, uuid, required — The ID of the system version.
    - `name` string, required — The name of the system version.

## Other responses

- `401` — Error indicating that the request is not authenticated.
- `500` — An internal service error indicating an issue with the Scorecard service.

## Changes

> 37 revisions in range; 1 could not be searched.

- **2025-06-27** `013895a80cfe` — 3 breaking, 3 warning, 5 info
  - removed the required property `configSchema` from the response with the `200` status
  - removed the required property `inputSchema` from the response with the `200` status
  - removed the required property `outputSchema` from the response with the `200` status
  - removed the request property `configSchema`
  - …7 more

[Change history](https://skmtc.dev/scorecard-ai/apis/scorecard-api/changes/systems/:systemId/patch.md)

---

[API](https://skmtc.dev/scorecard-ai/apis/scorecard-api.md) · [All operations](https://skmtc.dev/scorecard-ai/apis/scorecard-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scorecard-ai/scorecard-api/revisions/121aaa257802/schema)