---
title: "Update Run"
method: PUT
path: "/projects/{project_id}/runs/{run_id}"
tags: ["runs"]
---

# Update Run

`PUT /projects/{project_id}/runs/{run_id}`

Update a run's mutable fields (e.g. name).

## Path parameters

- `project_id` string, uuid4, required
- `run_id` string, uuid4, required

## Request body

- RunUpdateRequest
  - `name` string, nullable

## Response `200`

Successful Response

- UpdateRunResponse
  - `name` string, nullable
  - `project_id` string, uuid4, nullable
  - `created_by` string, uuid4, required
  - `num_samples` integer, required
  - `winner` boolean, required
  - `dataset_hash` string, nullable
  - `dataset_version_id` string, uuid4, nullable
  - `prompt_template_version_id` string, uuid4, nullable
  - `id` string, uuid4, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `task_type` 13 | 15 | 16 | 17 | 18 — Valid task types for modeling. We store these as ints instead of strings because we will be looking this up in the database frequently.
  - `last_updated_by` string, uuid4, required
  - `run_tags` RunTagDB[]
    - `key` string, required
    - `value` string, required
    - `tag_type` string, required
    - `project_id` string, uuid4, required
    - `run_id` string, uuid4, required
    - `created_by` string, uuid4, required
    - `id` string, uuid4, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/galileo/apis/galileo-api-server.md) · [All operations](https://skmtc.net/galileo/apis/galileo-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/galileo/galileo-api-server/versions/933e8c8e6366/schema)
