---
title: "Update Business"
method: PUT
path: "/api/v1/businesses/{business_id}"
tags: ["businesses"]
---

# Update Business

`PUT /api/v1/businesses/{business_id}`

Manually update business fields, marking each as human-set.

## Path parameters

- `business_id` string, uuid, required

## Request body

- BusinessManualUpdate — Manual field edits. Every field present in the body is written (and marked ``manual`` so a later import never clobbers a human edit).
  - `name` string, nullable
  - `website` string, nullable
  - `domain` string, nullable
  - `phone` string, nullable
  - `address` string, nullable
  - `category` string, nullable
  - `owner_user_id` string, uuid, nullable

## Response `200`

Successful Response

- BusinessRead — Full business record.
  - `id` string, uuid, required
  - `tenant_id` string, uuid, required
  - `name` string, required
  - `website` string, nullable
  - `domain` string, nullable
  - `phone` string, nullable
  - `address` string, nullable
  - `category` string, nullable
  - `owner_user_id` string, uuid, nullable
  - `total_revenue_cents` integer, nullable
  - `contact_count` integer, required
  - `first_seen_at` string, date-time, required
  - `last_seen_at` string, date-time, required

## Other responses

- `404` — Business not found
- `422` — Validation Error

## Changes

> 25 revisions in range; 1 not diffed.

- **2026-09-03** `d65b8fefae34` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/businesses/:business_id/put.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/704de2d43c75?raw)