# Update a lead property

### Update a lead property

`PATCH /api/v1/lead-properties/{key}`

Operation ID: `updateLeadProperty`

Change how a custom property is compared when filtering (type), or whether it shows as a column in the leads table. Stored values are not changed.

**Path parameters**

- `key` (string, required): Property key

**Request body** (required)

- `type` ("string" | "number" | "boolean" | "date", optional): How values are compared when filtering. Values are always stored as text; the type is guessed from the first value seen and can be changed.
- `showAsColumn` (boolean, optional): Show this property as a column in the leads table.

**200**: The updated property.

- `property` (object, required)
  - `key` (string, required): Property key. Filter on it as properties.<key>.
  - `type` ("string" | "number" | "boolean" | "date", required): How values are compared when filtering. Values are always stored as text; the type is guessed from the first value seen and can be changed.
  - `showAsColumn` (boolean, required): Shown as a column in the leads table.
  - `leadCount` (integer, required): Leads with a non-empty value.
  - `topValues` (object[], required): Up to 5 most common values, most common first.
- `requestId` (string · uuid, required): Id of this request, for support and troubleshooting

**Errors**

- `400`: Bad request
- `401`: Unauthorized: missing or invalid API key
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid request payload