Skip to main content
Section ID: DOC-API-MODEL-schema-1k2h0fdd77#overview

ScoreConfig

Score definition specifying its value type, bounds, and allowed categories.

Meaning and usage​

Section ID: DOC-API-MODEL-schema-1k2h0fdd77#meaning

See the definition above.

Usage profiles​

Section ID: DOC-API-MODEL-schema-1k2h0fdd77#fields

UsageFields and validation
In responsesView fields

In responses​

Section ID: DOC-API-MODEL-schema-1k2h0fdd77#response

API JSON uses JSON field names (camelCase).

FieldTypePresenceMeaning
Section ID: DOC-API-MODEL-schema-1k2h0fdd77#field-configidSection ID: DOC-API-MODEL-schema-1k2h0fdd77#response-field-configidconfigIdstringOptionalIdentifier of the score configuration defining the score’s value domain.
Section ID: DOC-API-MODEL-schema-1k2h0fdd77#field-nameSection ID: DOC-API-MODEL-schema-1k2h0fdd77#response-field-namenamestringOptionalName identifying the score definition.
Section ID: DOC-API-MODEL-schema-1k2h0fdd77#field-datatypeSection ID: DOC-API-MODEL-schema-1k2h0fdd77#response-field-datatypedataTypestring (SCORE_DATA_TYPE_NUMERIC, SCORE_DATA_TYPE_CATEGORICAL, SCORE_DATA_TYPE_BOOLEAN, SCORE_DATA_TYPE_TEXT) or integer (int32)Optional; explicit presenceValue type used to interpret numeric, categorical, Boolean, or text score values.
Section ID: DOC-API-MODEL-schema-1k2h0fdd77#field-descriptionSection ID: DOC-API-MODEL-schema-1k2h0fdd77#response-field-descriptiondescriptionstringOptionalHuman-readable description of the resource.
Section ID: DOC-API-MODEL-schema-1k2h0fdd77#field-minvalueSection ID: DOC-API-MODEL-schema-1k2h0fdd77#response-field-minvalueminValuenumber (double) or string (NaN, Infinity, -Infinity)OptionalMinimum numeric score value allowed by the score configuration.
Section ID: DOC-API-MODEL-schema-1k2h0fdd77#field-maxvalueSection ID: DOC-API-MODEL-schema-1k2h0fdd77#response-field-maxvaluemaxValuenumber (double) or string (NaN, Infinity, -Infinity)OptionalMaximum numeric score value allowed by the score configuration.
Section ID: DOC-API-MODEL-schema-1k2h0fdd77#field-categoriesSection ID: DOC-API-MODEL-schema-1k2h0fdd77#response-field-categoriescategoriesArray of ScoreConfigCategoryOptionalNamed score categories defined by the score configuration.
Section ID: DOC-API-MODEL-schema-1k2h0fdd77#field-isarchivedSection ID: DOC-API-MODEL-schema-1k2h0fdd77#response-field-isarchivedisArchivedbooleanOptionalWhether the score configuration is archived. Archived configurations are retained so historical scores remain interpretable.
Section ID: DOC-API-MODEL-schema-1k2h0fdd77#field-createdatSection ID: DOC-API-MODEL-schema-1k2h0fdd77#response-field-createdatcreatedAtstring (date-time)OptionalTime when this record was created.
Section ID: DOC-API-MODEL-schema-1k2h0fdd77#field-updatedatSection ID: DOC-API-MODEL-schema-1k2h0fdd77#response-field-updatedatupdatedAtstring (date-time)OptionalTime when this record was last updated.

Values of dataType​

Section ID: DOC-API-MODEL-schema-1k2h0fdd77#response-values-datatype

Scores

Data representation of an evaluation score or score configuration.

ValueNo.FormMeaning
SCORE_DATA_TYPE_NUMERIC0CanonicalA numeric measurement or rating.
SCORE_DATA_TYPE_CATEGORICAL1CanonicalA value chosen from a named set of categories.
SCORE_DATA_TYPE_BOOLEAN2CanonicalA true-or-false evaluation result.
SCORE_DATA_TYPE_TEXT3CanonicalFree-form text supplied by an evaluator or reviewer. The provider supports text values on score definitions and scores; support through this API depends on the operation.

Where used​

Section ID: DOC-API-MODEL-schema-1k2h0fdd77#where-used

ReferenceRelationship
List score configsPOST /api/v1/evals/list-score-configs
Update a score configPOST /api/v1/evals/update-score-config

Download the public reference contract.

Document ID: DOC-API-MODEL-schema-1k2h0fdd77