> ## 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.

# Get annotation task

> Get one annotation task with linked evaluators, items, and labelling jobs



## OpenAPI

````yaml /api-reference/openapi.json get /annotation-tasks/{task_uuid}
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}:
    get:
      tags:
        - annotation-tasks
      summary: Get annotation task
      description: >-
        Get one annotation task with linked evaluators, items, and labelling
        jobs
      operationId: get_annotation_task_endpoint_annotation_tasks__task_uuid__get
      parameters:
        - name: task_uuid
          in: path
          required: true
          schema:
            type: string
            description: Task to retrieve
            examples:
              - f47ac10b-58cc-4372-a567-0e02b2c3d479
            title: Task Uuid
          description: Task to retrieve
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnnotationTaskResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    AnnotationTaskResponse:
      properties:
        uuid:
          type: string
          maxLength: 36
          minLength: 36
          title: Uuid
          description: Unique ID for the task
          examples:
            - f47ac10b-58cc-4372-a567-0e02b2c3d479
        name:
          type: string
          title: Name
          description: Name of the task
        type:
          type: string
          enum:
            - stt
            - llm
            - llm-general
            - conversation
            - tts
          title: Type
          description: |-
            Task type. Determines the shape of each item's payload.
            - `stt`: judge a transcript on its own
            - `llm`: judge one response with its conversation history
            - `llm-general`: judge a standalone `input -> output` pair
            - `conversation`: judge a full conversation
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: The task's description
        created_at:
          type: string
          title: Created At
          description: When the task was created (ISO 8601 UTC)
        updated_at:
          type: string
          title: Updated At
          description: When the task was last updated (ISO 8601 UTC)
        evaluators:
          items:
            additionalProperties: true
            type: object
          type: array
          description: >-
            The evaluators linked to this task, in display order. Fetching one
            task by ID enriches each with its live version's rubric. Listing
            tasks returns lightweight metadata (uuid, name, type, position) only
          default: []
        item_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Item Count
          description: Number of items in the task
        has_agreement:
          type: boolean
          title: Has Agreement
          description: >-
            Whether the task has at least one comparable human-vs-human or
            human-vs-evaluator pair, computed over all time
          default: false
        items:
          items:
            additionalProperties: true
            type: object
          type: array
          description: >-
            The task's items, each with its agreement stats. You get these when
            you fetch one task by ID, not when you list tasks
          default: []
        jobs:
          items:
            additionalProperties: true
            type: object
          type: array
          description: >-
            The task's labelling jobs. You get these when you fetch one task by
            ID, not when you list tasks
          default: []
      type: object
      required:
        - uuid
        - name
        - type
        - created_at
        - updated_at
      title: AnnotationTaskResponse
    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

````