---
title: "Update a client (e.g. rename)"
method: PATCH
path: "/v1/clients/{client_id}"
tags: ["Clients"]
---

# Update a client (e.g. rename)

`PATCH /v1/clients/{client_id}`

## Request

- Base URL: `https://api.magnetictax.com`
- URL: `https://api.magnetictax.com/v1/clients/{client_id}`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string

## Request body

- UpdateClientRequest
  - `friendly_name` string
  - `taxpayer_tin` integer, nullable

## Response `200`

OK

- Client
  - `created_at` string, date-time
  - `friendly_name` string
  - `id` integer
  - `taxpayer_tin` integer, nullable

## Other responses

- `404`: Not found
- `409`: Idempotency-Key conflict — reused for a different request (`idempotency_key_reuse`), or the original request is still running (`idempotency_request_in_progress`)
- `429`: Rate limited — retry after the `Retry-After` delay

---

[API](https://skmtc.dev/magnetictax/apis/magnetic-integrations-api.md) - [All operations](https://skmtc.dev/magnetictax/apis/magnetic-integrations-api/llms.txt) - [OpenAPI document](https://skmtc.dev/magnetictax/apis/magnetic-integrations-api/revisions/11854873aa89?raw)