---
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`

## Request

- Base URL: `https://api.getauctor.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getauctor.com/v2/spaces/{space_id}/custom-fields`
- Auth: none declared

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. A Link (`url`) field takes the URL as a string, or an object `{"url": "...", "display_text": "OPTY0012345"}` to show that text as the link. A plain string sets the URL with no display text.

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. `url` fields also take an object with `url` and `display_text`.

## 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
    - `display_text` string, nullable: `url` fields only: text shown in place of the URL, or `null`.
  - `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

## Changes

- **2026-10-23** `c916e63d6cb2`: 2 info
  - added `#/components/schemas/PublicLinkValue` to the `values/additionalProperties/` request property `anyOf` list
  - added the optional property `data/items/display_text` to the response with the `200` status
- **2026-09-01** `aeb6faa3b8f0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getauctor/apis/getauctor-api/changes/v2/spaces/:space_id/custom-fields/patch.md)

---

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