---
title: "Update Score Config"
method: PATCH
path: "/data-quality/v1/score/configs/{configId}"
tags: ["Score"]
---

# Update Score Config

`PATCH /data-quality/v1/score/configs/{configId}`

## Request

- Base URL: `https://api.zoominfo.com/gtm`
- URL: `https://api.zoominfo.com/gtm/data-quality/v1/score/configs/{configId}`
- Auth: OAuth 2
  - Authorization code: `https://login.zoominfo.com`
  - Token URL: `https://okta-login.zoominfo.com/oauth2/default/v1/token` scopes: `api:data-quality:manage`

Partially updates a score configuration. Only the attributes present in the request body
are changed; omitted attributes are left untouched, so you do not need to resend the whole
model to change one weight.

Use this to retune weights or adjust elements rather than creating a second model and
re-pointing the runs that reference it.

Server-assigned fields — `id`, `status`, `modelType`, `fieldsUsedInRules`, and timestamps —
are ignored on input. `fieldsUsedInRules` is re-derived when you change the rules.

Returns `200` with the updated score config. Returns `400` if the payload is malformed and
`404` if no config has the given `configId`.

This endpoint does not consume credits.

## Path parameters

- `configId` string, required

## Request body

- ScoreConfigJsonApiModelUpdate: JSON API model for a single score config.
  - `data` ScoreConfigUpdate: A score configuration resource (identity, model type, and scoring elements).
    - `id` string: The unique identifier for the resource
    - `type` string: The type of the resource
    - `attributes` ScoreConfigAttributesUpdate: Attributes of a score configuration.
      - `name` string: Display name for the score config.
      - `elements` ScoreElement[]: Ordered scoring elements that define how records are scored.
        - `field` string, required: Name of the input field this element scores.
        - `weight` number, double, required: Relative weight of this element in the weighted sum. Between `0` and `100`.
        - `rules` ScoreRule[], required: Ordered rules evaluated for this element.
          - `name` string, required: Display name for the rule.
          - `score` number, double, required: Score contributed by this rule when its criteria match.
          - `criteria` ScoreCriterion[], required: Ordered criteria evaluated for this rule. At least one is required.
            - `operator` 'TEXT_EQUALS' | 'TEXT_NOT_EQUALS' | 'TEXT_CONTAINS' | 'TEXT_NOT_CONTAINS' | 'TEXT_STARTS' | 'TEXT_NOT_STARTS' | 'TEXT_ENDS' | 'TEXT_NOT_ENDS' | 'NUM_EQUALS' | 'NUM_MORE' | 'NUM_LESS' | 'NUM_BETWEEN' | 'BOOL_TRUE' | 'BOOL_FALSE' | 'IS_NULL' | 'IS_NOT_NULL' | 'DATE_EXACT' | 'DATE_AFTER' | 'DATE_BEFORE' | 'PICKLIST_EQUALS' | 'PICKLIST_NOT_EQUALS' | 'MULTIPICKLIST_EQUALS' | 'MULTIPICKLIST_NOT_EQUALS' | 'MULTIPICKLIST_HAS' | 'MULTIPICKLIST_HAS_NONE' | 'MULTIPICKLIST_HAS_ALL' | 'DIVIDER', required: Comparison operator for a score rule criterion.
            - `values` string[]: Operand values for the operator. Omitted for nullary operators (boolean and null checks) and for `DIVIDER`; a single entry for most text, number, and date operators; exactly two for `NUM_BETWEEN`.

## Response `200`

Success

- ScoreConfigJsonApiModel: JSON API model for a single score config.
  - `data` ScoreConfig, required: A score configuration resource (identity, model type, and scoring elements).
    - `id` string, required: The unique identifier for the resource
    - `type` string, required: The type of the resource
    - `attributes` ScoreConfigAttributes, required: Attributes of a score configuration.
      - `name` string, required: Display name for the score config.
      - `status` 'ACTIVE' | 'ARCHIVED', required: Lifecycle status of a score configuration.
      - `modelType` 'ATTRIBUTE', required: Type of scoring model.
      - `elements` ScoreElement[], required: Ordered scoring elements that define how records are scored.
        - `field` string, required: Name of the input field this element scores.
        - `weight` number, double, required: Relative weight of this element in the weighted sum. Between `0` and `100`.
        - `rules` ScoreRule[], required: Ordered rules evaluated for this element.
          - `name` string, required: Display name for the rule.
          - `score` number, double, required: Score contributed by this rule when its criteria match.
          - `criteria` ScoreCriterion[], required: Ordered criteria evaluated for this rule. At least one is required.
            - `operator` 'TEXT_EQUALS' | 'TEXT_NOT_EQUALS' | 'TEXT_CONTAINS' | 'TEXT_NOT_CONTAINS' | 'TEXT_STARTS' | 'TEXT_NOT_STARTS' | 'TEXT_ENDS' | 'TEXT_NOT_ENDS' | 'NUM_EQUALS' | 'NUM_MORE' | 'NUM_LESS' | 'NUM_BETWEEN' | 'BOOL_TRUE' | 'BOOL_FALSE' | 'IS_NULL' | 'IS_NOT_NULL' | 'DATE_EXACT' | 'DATE_AFTER' | 'DATE_BEFORE' | 'PICKLIST_EQUALS' | 'PICKLIST_NOT_EQUALS' | 'MULTIPICKLIST_EQUALS' | 'MULTIPICKLIST_NOT_EQUALS' | 'MULTIPICKLIST_HAS' | 'MULTIPICKLIST_HAS_NONE' | 'MULTIPICKLIST_HAS_ALL' | 'DIVIDER', required: Comparison operator for a score rule criterion.
            - `values` string[]: Operand values for the operator. Omitted for nullary operators (boolean and null checks) and for `DIVIDER`; a single entry for most text, number, and date operators; exactly two for `NUM_BETWEEN`.
      - `fieldsUsedInRules` string[], required: Distinct input field names referenced by this config's elements, sorted alphabetically. Read-only; derived from `elements[].field`.
    - `meta` ScoreConfigMeta: Non-standard metadata for a score config.
      - `createdAt` string, date-time, required: ISO 8601 timestamp at which this score config was created.
      - `updatedAt` string, date-time, required: ISO 8601 timestamp at which this score config was last updated.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests

---

[API](https://skmtc.dev/zoominfo/apis/data-quality-api-v1.md) - [All operations](https://skmtc.dev/zoominfo/apis/data-quality-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/zoominfo/apis/data-quality-api-v1/revisions/7229ed1f3b09?raw)