---
title: "Ensure a score config exists with these parameters"
method: PUT
path: "/api/{org_id}/score_configs"
tags: ["ScoreConfigs"]
---

# Ensure a score config exists with these parameters

`PUT /api/{org_id}/score_configs`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/score_configs`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/score_configs/put.ts> (a function with typed inputs; its response is checked against the schema)

Creates the score config when it is absent, does nothing when every parameter already matches, and appends a new version when a structural parameter (range, categories, healthy threshold) differs. A different data type is refused: changing what a dimension measures needs a different name.

## Path parameters

- `org_id` string, required

## Request body

- object: HTTP request body for ensuring a Score Config exists. Safe to send on every run: identical parameters change nothing, a changed range or category set appends a version, and a different data type is refused.
  - `categories` unknown
  - `dataType` string, required
  - `description` string, nullable
  - `healthyThreshold` unknown
  - `name` string, required
  - `numericRange` unknown

## Response `200`

- object
  - `config` ScoreConfigResponseBody, required: HTTP response body for a Score Config.
    - `categories` unknown
    - `createdAt` integer, required
    - `dataType` string, required
    - `description` string, nullable
    - `entityId` string, required
    - `healthyThreshold` unknown
    - `id` string, required
    - `isActive` boolean, required
    - `name` string, required
    - `numericRange` unknown
    - `orgId` string, required
    - `updatedAt` integer, required
    - `version` integer, required
  - `outcome` 'created' | 'unchanged' | 'version_bumped', required

## Other responses

- `400`: Bad Request
- `409`: Data type differs from the existing score config

---

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