Sign in

v2

latestOpenAPI 3.1.02026-07-26143251806.6 KB
tables

Configure Table Sheet Score

Configure scoring for a Table sheet. This endpoint updates the configuration and returns whether recalculation is required; it does not queue score calculation. Requests are scoped to the workspace associated with the API key; table, sheet, column, cell, operation, and version IDs must belong to that workspace.

patch/api/public/v2/tables/{table_id}/sheets/{sheet_id}/score

Path parameters

table_idstring uuid required

Table ID.

sheet_idstring uuid required

Table sheet ID.

Headers

X-API-KEYstring required

Your PromptLayer API key. The key's workspace scopes table resources for this request.

Request body

score_type'auto' | 'boolean' | 'numeric' | 'custom' nullable

Scoring mode. Required when score_config is provided.

score_configobject nullable

Explicit score configuration.

column_idsstring[] nullable

Column IDs to score.

column_namesstring[] nullable

Column titles to score. Titles must be unique in the sheet.

codestring nullable

Custom scoring code.

code_language'PYTHON' | 'JAVASCRIPT'
true_valuesstring[] nullable

Values treated as true for boolean scoring.

false_valuesstring[] nullable

Values treated as false for boolean scoring.

assertion_aggregation'all' | 'any' | 'mean' nullable

Aggregation mode for assertion-style boolean scoring.

Response

Score configuration updated.

successboolean required
messagestring required
score_configuration_idstring uuid required
statusstring nullable required

Returned as null by this endpoint. Use the recalculation endpoint to queue score calculation.

requires_recalculationboolean required

Always true after updating the score configuration.

versioninteger required