---
title: "Update a Run"
method: PATCH
path: "/runs/{run_id}"
tags: ["runs"]
---

# Update a Run

`PATCH /runs/{run_id}`

Updates a run identified by its ID. The body should contain only the fields to be changed; unknown fields are ignored.

## Path parameters

- `run_id` string, uuid, required

## Request body

- RunsRun
  - `dotted_order` string
  - `end_time` string
  - `error` string
  - `events` object[]
  - `extra` object
  - `id` string
  - `input_attachments` object
  - `inputs` object
  - `name` string
  - `output_attachments` object
  - `outputs` object
  - `parent_run_id` string
  - `reference_example_id` string
  - `run_type` 'tool' | 'chain' | 'llm' | 'retriever' | 'embedding' | 'prompt' | 'parser'
  - `serialized` object
  - `session_id` string
  - `session_name` string
  - `start_time` string
  - `status` string
  - `tags` string[]
  - `trace_id` string

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity
- `429` — Too Many Requests

---

[API](https://skmtc.net/langchain-ai/apis/langsmith.md) · [All operations](https://skmtc.net/langchain-ai/apis/langsmith/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langchain-ai/langsmith/versions/a0acb3a6a101/schema)