---
title: "Update Field Configuration"
method: PATCH
path: "/field-configurations/{id}"
tags: ["Field Configuration"]
---

# Update Field Configuration

`PATCH /field-configurations/{id}`

Partially updates a field configuration. Only properties present on the body are modified (PATCH semantics). Field configurations belonging to other organizations return 404.

## Path parameters

- `id` string, required

## Request body

- UpdateFieldConfigurationRequest — Request payload for updating a field configuration. Uses PATCH semantics - only fields present in the body are updated; omitted fields are left unchanged.
  - `name` string — New human-readable name. When present, trimmed; 1-128 characters.
  - `teamsUUID` string[] — Replacement list of team UUIDs this configuration is assigned to. When omitted, existing assignments are preserved.
  - `allTeams` boolean, nullable — When present, sets whether the configuration applies to every team in the organization.
  - `criteria` FieldConfigurationCriteria — Criteria expression that controls when this field configuration applies. Conditions are combined using the specified boolean operator.
    - `conditions` FieldConfigurationCriteriaCondition[] — Ordered list of conditions to evaluate.
      - `field` string — Name of the field the condition applies to.
      - `value` string — Value the field must match for this condition.
    - `operator` 'AND' | 'OR' — Boolean operator used to combine the conditions.

## Response `200`

Field configuration successfully updated.

- FieldConfigurationResponse — Envelope containing a single field configuration.
  - `data` FieldConfiguration — A Field Configuration (internally `IntelligenceItemCollection`) groups a set of intelligence items that are surfaced together for the teams it is assigned to. Field Configurations are scoped to a single organization.
    - `uuid` string, required — Unique identifier of the field configuration.
    - `name` string, required — Human-readable name of the field configuration.
    - `organizationUUID` string, required — UUID of the organization the field configuration belongs to.
    - `teamsUUID` string[], required — UUIDs of the teams this field configuration is assigned to. Ignored when `allTeams` is true.
    - `allTeams` boolean, required — When true, this configuration applies to every team in the organization and `teamsUUID` is ignored.
    - `isDefaultTemplate` boolean, required — Whether this configuration is the organization's default template.
    - `criteria` FieldConfigurationCriteria — Criteria expression that controls when this field configuration applies. Conditions are combined using the specified boolean operator.
      - `conditions` FieldConfigurationCriteriaCondition[] — Ordered list of conditions to evaluate.
        - `field` string — Name of the field the condition applies to.
        - `value` string — Value the field must match for this condition.
      - `operator` 'AND' | 'OR' — Boolean operator used to combine the conditions.
    - `createdAt` string, date-time, required — Timestamp when the configuration was created.

## Other responses

- `400` — Invalid body parameters or nothing mutable supplied.
- `401` — Authentication failed. Please provide a valid API key.
- `404` — No field configuration with the provided UUID exists in the organization.
- `409` — A field configuration with the same name already exists in the organization.
- `422` — Schema-level validation failure on the request body (e.g. value outside the allowed length range).
- `default` — Unexpected error.

---

[API](https://skmtc.net/attention/apis/attention-service-v2.md) · [All operations](https://skmtc.net/attention/apis/attention-service-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attention/attention-service-v2/revisions/5de55d3804cf/schema)