> ## Documentation Index
> Fetch the complete documentation index at: https://docs.promptlayer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Recalculate Score

> Queue recalculation for an existing Table sheet score configuration. Requests are scoped to the workspace associated with the API key; table, sheet, column, cell, operation, and version IDs must belong to that workspace.

Queue recalculation for an existing sheet score configuration.

This endpoint requires scoring to already be configured on the sheet. The response returns the `score_configuration_id` and score calculation `status` (`queued`, `running`, `completed`, `failed`, or `null`).


## OpenAPI

````yaml POST /api/public/v2/tables/{table_id}/sheets/{sheet_id}/score
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers: []
security:
  - ApiKeyAuth: []
paths:
  /api/public/v2/tables/{table_id}/sheets/{sheet_id}/score:
    post:
      tags:
        - tables
      summary: Recalculate Table Sheet Score
      description: >-
        Queue recalculation for an existing Table sheet score configuration.
        Requests are scoped to the workspace associated with the API key; table,
        sheet, column, cell, operation, and version IDs must belong to that
        workspace.
      operationId: recalculateTableSheetScore
      parameters:
        - name: X-API-KEY
          in: header
          required: true
          schema:
            type: string
          description: >-
            Your PromptLayer API key. The key's workspace scopes table resources
            for this request.
        - name: table_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Table ID.
        - name: sheet_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Table sheet ID.
      responses:
        '202':
          description: Score recalculation queued.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecalculateTableSheetScoreResponse'
        '400':
          description: Score is not configured or score configuration is invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Table or sheet not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Failed to queue score calculation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    RecalculateTableSheetScoreResponse:
      type: object
      title: RecalculateTableSheetScoreResponse
      required:
        - success
        - score_configuration_id
        - status
      properties:
        success:
          type: boolean
        score_configuration_id:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - queued
            - running
            - completed
            - failed
            - null
          nullable: true
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          default: false
          description: Indicates that the request failed.
        message:
          type: string
          description: Human-readable error message.
        error:
          type: string
          description: Machine-readable or fallback error message.
      additionalProperties: true
      description: >-
        Standard error response. Some legacy endpoints may return either message
        or error.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY

````