---
title: "PATCH /leads/{id}"
method: PATCH
path: "/leads/{id}"
tags: ["Lead"]
---

# PATCH /leads/{id}

`PATCH /leads/{id}`

## Path parameters

- `id` string, required

## Request body

- UpdateLeadRequest — Gap 8: Update lead via Public API. All fields are optional (PATCH semantics). Allowed status values mirror the admin kanban whitelist (LeadController::index statuses array) plus the open-quote states used in Lead::findRecentOpenForCustomer.
  - `event_date` string, date-time, nullable
  - `event_type` string, nullable
  - `status` 'new' | 'contacted' | 'draft' | 'quoted' | 'engaged' | 'won' | 'lost' | 'archived'
  - `notes` string, nullable
  - `source` string, nullable
  - `metadata` string[], nullable

## Response `200`

- string

## Other responses

- `422` — Validation error

---

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