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

# Update task evaluators

> Replace a task's linked evaluators with the given ordered set, linking, unlinking, and reordering as needed



## OpenAPI

````yaml /api-reference/openapi.json put /annotation-tasks/{task_uuid}/evaluators
openapi: 3.1.0
info:
  title: Calibrate Public API
  version: 0.1.0
  description: Programmatic API for CI/automation. Pass your key in the `X-API-Key` header.
servers:
  - url: https://api.calibrate.artpark.ai
    description: Production
security: []
paths:
  /annotation-tasks/{task_uuid}/evaluators:
    put:
      tags:
        - annotation-tasks
      summary: Update task evaluators
      description: >-
        Replace a task's linked evaluators with the given ordered set, linking,
        unlinking, and reordering as needed
      operationId: set_task_evaluators_annotation_tasks__task_uuid__evaluators_put
      parameters:
        - name: task_uuid
          in: path
          required: true
          schema:
            type: string
            description: Annotation task to act on
            examples:
              - f47ac10b-58cc-4372-a567-0e02b2c3d479
            title: Task Uuid
          description: Annotation task to act on
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EvaluatorSetRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EvaluatorSetResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    EvaluatorSetRequest:
      properties:
        evaluator_ids:
          items:
            type: string
          type: array
          title: Evaluator Ids
          description: >-
            The full ordered set of evaluators the task should end up linked to,
            in display order. Missing ones are unlinked, new ones are linked,
            and the order sets their position. Send an empty list to unlink all.
            Each must be one you created or a built-in default
          examples:
            - - f47ac10b-58cc-4372-a567-0e02b2c3d479
      type: object
      required:
        - evaluator_ids
      title: EvaluatorSetRequest
    EvaluatorSetResponse:
      properties:
        message:
          type: string
          title: Message
          description: Confirmation that the task's evaluators were updated
          examples:
            - Task evaluators updated
        evaluator_ids:
          items:
            type: string
          type: array
          title: Evaluator Ids
          description: The task's evaluator IDs after the update, in display order
        linked:
          items:
            type: string
          type: array
          title: Linked
          description: Evaluator IDs newly linked by this request
        unlinked:
          items:
            type: string
          type: array
          title: Unlinked
          description: Evaluator IDs unlinked by this request
      type: object
      required:
        - message
        - evaluator_ids
        - linked
        - unlinked
      title: EvaluatorSetResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key for authentication

````