---
title: "Update Market Lead"
method: PATCH
path: "/market-leads/{lead_id}"
tags: ["market-leads"]
---

# Update Market Lead

`PATCH /market-leads/{lead_id}`

## Path parameters

- `lead_id` string, required

## Request body

- MarketLeadUpdateRequest
  - `status` 'received' | 'contacted' | 'engaged' | 'collecting' | 'not_qualified' | 'qualified_ready_to_book' | 'service_titan_job_created' | 'won' | 'lost' | 'error', nullable
  - `ai_paused` boolean, nullable
  - `needs_office` boolean, nullable

## Response `200`

Successful Response

- MarketLeadSummary
  - `id` string, required
  - `source_key` string, required
  - `source_display_name` string, nullable
  - `customer_name` string, nullable
  - `phone` string, nullable
  - `email` string, nullable
  - `primary_contact_method` string, required
  - `preferred_contact_method` string, required
  - `status` string, required
  - `qualification_status` string, required
  - `service_category` string, nullable
  - `project_details` string, nullable
  - `ai_paused` boolean
  - `needs_office` boolean
  - `st_job_id` union
    - integer
    - string
  - `st_booking_status` string, nullable
  - `st_booking_started_at` string, date-time, nullable
  - `st_booking_error` string, nullable
  - `backoffice_notification_status` string, nullable
  - `first_contacted_at` string, date-time, nullable
  - `last_message_at` string, date-time, nullable
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable

## Other responses

- `404` — Not found
- `422` — Validation Error

---

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