---
title: "Update customer"
method: PATCH
path: "/customers/{id}"
tags: ["Customers"]
---

# Update customer

`PATCH /customers/{id}`

## Request

- Base URL: `https://api.getmaintainx.com/v1`
- URL: `https://api.getmaintainx.com/v1/customers/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` integer, required

## Headers

- `x-organization-id` integer

## Request body

- object
  - `name` string: Name of the customer
  - `description` string, nullable: Description of the customer
  - `extraFields` object: Customer custom fields, keyed by field label

## Response `200`

Successfully updated customer

- object
  - `customer` ExternalCustomer, required
    - `id` integer, required: Global ID of the customer
    - `name` string, required: Name of the customer
    - `description` string, nullable, required: Description of the customer
    - `archivedAt` string, date-time, nullable, required: Date the customer was archived. Null if the customer is active.
    - `createdAt` string, date-time, required: Date the customer was created
    - `updatedAt` string, date-time, required: Date the customer was last updated
    - `extraFields` object, required: Customer custom fields, keyed by field label

## Other responses

- `400`: Invalid request
- `401`: Invalid token
- `403`: Forbidden

## Changes

> 30 revisions in range; 1 not diffed.

- **2026-09-24** `67648fe5c36d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getmaintainx/apis/maintainx-api/changes/customers/:id/patch.md)

---

[API](https://skmtc.dev/getmaintainx/apis/maintainx-api.md) - [All operations](https://skmtc.dev/getmaintainx/apis/maintainx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getmaintainx/apis/maintainx-api/revisions/6258367c04ff?raw)