---
title: "Update a custom column"
method: PATCH
path: "/v1/custom_columns/{custom_column_id}"
tags: ["Custom column"]
---

# Update a custom column

`PATCH /v1/custom_columns/{custom_column_id}`

Updates a custom column. The caller must be a member of the company that owns the column.
All fields are optional; only the provided fields are changed.

## Path parameters

- `custom_column_id` string, uuid, required

## Headers

- `company-id` string, uuid, required

## Request body

- CustomColumnUpdate — Payload to update a custom column. All fields are optional; only the provided fields are changed. The caller must be a member of the company that owns the column.
  - `label` string
  - `internal_name` string
  - `field` string
  - `source_table` string
  - `default_value` string
  - `applicable_models` string[]
  - `options` object[]
    - `key` string
    - `value` string

## Response `200`

Custom column updated

- CustomColumn — A custom column definition — a company-configurable field ("rendición" / expense-tracking metadata) that can be attached to transactions and other applicable models. Values are stored per record and surfaced through `custom_column_values`.
  - `id` string, uuid, required
  - `company_id` string, uuid, required
  - `label` string — Human-facing label shown in the UI.
  - `internal_name` string, nullable — Internal name used for programmatic references.
  - `field` string — The field/input type of the column. `options` drives a select-style column with a fixed set of choices.
  - `source_table` string, nullable — The source table the column reads from, when applicable.
  - `default_value` string, nullable — Default value applied when no value is set.
  - `applicable_models` string[] — The models this column applies to (e.g. `transactions`, `card_transactions`, `payables`).
  - `options` object[] — For option-type columns, the allowed key/value choices.
    - `key` string
    - `value` string
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401` — Unauthorized
- `404` — Custom column not found
- `422` — Validation error

---

[API](https://skmtc.dev/cardda/apis/banking-api.md) · [All operations](https://skmtc.dev/cardda/apis/banking-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cardda/banking-api/revisions/ff1aeb3fda8b/schema)