---
title: "Patch Space Custom Fields"
method: PATCH
path: "/v2/spaces/{space_id}/custom-fields"
tags: ["spaces"]
---

# Patch Space Custom Fields

`PATCH /v2/spaces/{space_id}/custom-fields`

Update custom field values on an account or project space. Send a `values` map keyed by custom field ID (UUID) — fields you omit are left untouched, and a `null` value clears the field.

The response returns the full field collection after the update plus `changed_field_ids`, listing only the fields whose value actually changed. An audit event (`account.updated` / `project.updated`) is recorded when at least one field changed.

Errors: `422` when a key is not a valid UUID, names a field the space's template does not define, or the value fails the field's validation (for example clearing a required field); `404` when the space does not exist in your organization; `409` when the space has no custom fields to update; `502` when the custom fields service is unavailable.

## Path parameters

- `space_id` string, required

## Request body

- CustomFieldsPatchRequest
  - `values` object, required — Map of custom field ID (UUID) to new value. `null` clears the field.

## Response `200`

Successful Response

- PublicCustomFieldsUpdate
  - `data` PublicCustomField[], required
    - `id` string, uuid, required
    - `name` string, required
    - `type` string, required
    - `required` boolean, required
    - `order` integer, required
    - `default_value` unknown, required
    - `properties` object, required
    - `value` unknown
  - `total` integer, required
  - `changed_field_ids` string[], required — IDs of the fields whose value actually changed as a result of the request.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/getauctor/apis/fastapi.md) · [All operations](https://skmtc.dev/getauctor/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getauctor/fastapi/revisions/aeb6faa3b8f0/schema)