naftiko: 1.0.0-alpha2
info:
  label: API Reference — subpackage_projects.subpackage_projects/stats
  description: 'API Reference — subpackage_projects.subpackage_projects/stats. 20 operations. Lead operation: ✨ Get model-version
    overall agreement vs annotators. Self-contained Naftiko capability covering one Label Studio business surface.'
  tags:
  - Label Studio
  - subpackage_projects.subpackage_projects/stats
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    LABEL_STUDIO_API_KEY: LABEL_STUDIO_API_KEY
capability:
  consumes:
  - type: http
    namespace: label-studio-subpackage-projects-subpackage-projects-stats
    baseUri: http://localhost:8000
    description: API Reference — subpackage_projects.subpackage_projects/stats business capability. Self-contained, no shared
      references.
    resources:
    - name: api-projects-id-model-stats-model_version-agreement
      path: /api/projects/{id}/model-stats/{model_version}/agreement
      operations:
      - name: modelversionannotatoragreement
        method: GET
        description: ✨ Get model-version overall agreement vs annotators
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
        - name: model_version
          in: path
          type: string
          required: true
        - name: Authorization
          in: header
          type: string
          description: 'The token (or API key) must be passed as a request header. You can find your user token on the User
            Account page in Label Studio. Example: <br><pre><code class='
          required: true
    - name: api-projects-id-model-stats-model_version-agreement-groundtruth
      path: /api/projects/{id}/model-stats/{model_version}/agreement-groundtruth
      operations:
      - name: modelversiongroundtruthagreement
        method: GET
        description: ✨ Get model-version ground truth agreement
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
        - name: model_version
          in: path
          type: string
          required: true
        - name: per_label
          in: query
          type: boolean
          description: Calculate agreement per label
        - name: Authorization
          in: header
          type: string
          description: 'The token (or API key) must be passed as a request header. You can find your user token on the User
            Account page in Label Studio. Example: <br><pre><code class='
          required: true
    - name: api-projects-id-model-stats-model_version-prediction
      path: /api/projects/{id}/model-stats/{model_version}/prediction
      operations:
      - name: modelversionpredictionagreement
        method: GET
        description: ✨ Get model-version prediction agreement
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
        - name: model_version
          in: path
          type: string
          required: true
        - name: per_label
          in: query
          type: boolean
          description: Calculate agreement per label
        - name: Authorization
          in: header
          type: string
          description: 'The token (or API key) must be passed as a request header. You can find your user token on the User
            Account page in Label Studio. Example: <br><pre><code class='
          required: true
    - name: api-projects-id-stats-IAA
      path: /api/projects/{id}/stats/IAA
      operations:
      - name: iaa
        method: GET
        description: ✨ Get Inter-Annotator Agreement matrix
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
        - name: expand
          in: query
          type: string
          description: Comma-separated list of fields to expand
        - name: per_label
          in: query
          type: boolean
          description: Calculate IAA per label
        - name: std
          in: query
          type: boolean
          description: Include standard deviation in results
        - name: task
          in: query
          type: string
          description: Comma-separated list of task IDs to filter by
        - name: Authorization
          in: header
          type: string
          description: 'The token (or API key) must be passed as a request header. You can find your user token on the User
            Account page in Label Studio. Example: <br><pre><code class='
          required: true
    - name: api-projects-id-stats-agreement-groundtruth
      path: /api/projects/{id}/stats/agreement-groundtruth
      operations:
      - name: usersgroundtruthagreement
        method: GET
        description: ✨ Get ground truth agreement for multiple users
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
        - name: ids
          in: query
          type: string
          description: Comma separated list of user IDs to get ground truth agreement for
          required: true
        - name: per_label
          in: query
          type: boolean
          description: Per label
        - name: Authorization
          in: header
          type: string
          description: 'The token (or API key) must be passed as a request header. You can find your user token on the User
            Account page in Label Studio. Example: <br><pre><code class='
          required: true
    - name: api-projects-id-stats-agreement_annotator-user_id
      path: /api/projects/{id}/stats/agreement_annotator/{user_id}
      operations:
      - name: agreementannotator
        method: GET
        description: ✨ Get individual annotator agreement stats
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
        - name: user_id
          in: path
          type: integer
          required: true
        - name: Authorization
          in: header
          type: string
          description: 'The token (or API key) must be passed as a request header. You can find your user token on the User
            Account page in Label Studio. Example: <br><pre><code class='
          required: true
    - name: api-projects-id-stats-agreement_annotators
      path: /api/projects/{id}/stats/agreement_annotators
      operations:
      - name: agreementannotators
        method: GET
        description: ✨ Get agreement statistics for multiple annotators
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
        - name: ids
          in: query
          type: string
          description: Comma separated list of annotator user IDs to get agreement scores for
          required: true
        - name: Authorization
          in: header
          type: string
          description: 'The token (or API key) must be passed as a request header. You can find your user token on the User
            Account page in Label Studio. Example: <br><pre><code class='
          required: true
    - name: api-projects-id-stats-data_filter
      path: /api/projects/{id}/stats/data_filter
      operations:
      - name: datafilters
        method: GET
        description: ✨ Get user data filter statistics
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
        - name: Authorization
          in: header
          type: string
          description: 'The token (or API key) must be passed as a request header. You can find your user token on the User
            Account page in Label Studio. Example: <br><pre><code class='
          required: true
    - name: api-projects-id-stats-finished
      path: /api/projects/{id}/stats/finished
      operations:
      - name: finishedtasks
        method: GET
        description: ✨ Get finished tasks statistics
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
        - name: user_pk
          in: query
          type: integer
          description: User ID to filter statistics by (optional)
        - name: Authorization
          in: header
          type: string
          description: 'The token (or API key) must be passed as a request header. You can find your user token on the User
            Account page in Label Studio. Example: <br><pre><code class='
          required: true
    - name: api-projects-id-stats-label-distribution-counts
      path: /api/projects/{id}/stats/label-distribution/counts
      operations:
      - name: labeldistributioncounts
        method: GET
        description: ✨ Get label distribution counts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
        - name: choice_keys
          in: query
          type: string
          description: 'Explicit choice keys to fetch, joined by "___PIPE___" (for example: "label___SEP___pos___PIPE___quality___SEP___4").
            When provided, pagination params are ignore'
        - name: limit
          in: query
          type: integer
          description: Maximum number of choice keys to return for pagination. Ignored when `choice_keys` is provided.
        - name: offset
          in: query
          type: integer
          description: Zero-based offset into the structure `choice_keys` list. Used only when `choice_keys` is not provided.
        - name: Authorization
          in: header
          type: string
          description: 'The token (or API key) must be passed as a request header. You can find your user token on the User
            Account page in Label Studio. Example: <br><pre><code class='
          required: true
    - name: api-projects-id-stats-label-distribution-structure
      path: /api/projects/{id}/stats/label-distribution/structure
      operations:
      - name: labeldistributionstructure
        method: GET
        description: ✨ Get label distribution structure
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
        - name: Authorization
          in: header
          type: string
          description: 'The token (or API key) must be passed as a request header. You can find your user token on the User
            Account page in Label Studio. Example: <br><pre><code class='
          required: true
    - name: api-projects-id-stats-lead_time
      path: /api/projects/{id}/stats/lead_time
      operations:
      - name: leadtime
        method: GET
        description: ✨ Get lead time statistics
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
        - name: Authorization
          in: header
          type: string
          description: 'The token (or API key) must be passed as a request header. You can find your user token on the User
            Account page in Label Studio. Example: <br><pre><code class='
          required: true
    - name: api-projects-id-stats-member_performance_rows
      path: /api/projects/{id}/stats/member_performance_rows/
      operations:
      - name: memberperformancerows
        method: GET
        description: ✨ Get paginated member performance rows
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
        - name: ids
          in: query
          type: string
          description: Comma-separated user IDs to include. When omitted, members are derived from the project.
        - name: ordering
          in: query
          type: string
          description: Sort field; prefix with "-" for descending (e.g. "-finished").
        - name: page
          in: query
          type: integer
          description: 1-based page index.
        - name: page_size
          in: query
          type: integer
          description: Page size (1–100).
        - name: table
          in: query
          type: string
          description: 'Which table to load: "annotations" or "reviews".'
        - name: Authorization
          in: header
          type: string
          description: 'The token (or API key) must be passed as a request header. You can find your user token on the User
            Account page in Label Studio. Example: <br><pre><code class='
          required: true
    - name: api-projects-id-stats-total_agreement
      path: /api/projects/{id}/stats/total_agreement
      operations:
      - name: totalagreement
        method: GET
        description: ✨ Get total agreement for project
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
        - name: per_label
          in: query
          type: boolean
          description: Return agreement per label
        - name: Authorization
          in: header
          type: string
          description: 'The token (or API key) must be passed as a request header. You can find your user token on the User
            Account page in Label Studio. Example: <br><pre><code class='
          required: true
    - name: api-projects-id-update-stats
      path: /api/projects/{id}/update-stats
      operations:
      - name: updatestats
        method: GET
        description: ✨ Start stats recalculation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
        - name: stat_type
          in: query
          type: string
          description: 'Stat type to recalculate. Possible values: label, stats'
        - name: Authorization
          in: header
          type: string
          description: 'The token (or API key) must be passed as a request header. You can find your user token on the User
            Account page in Label Studio. Example: <br><pre><code class='
          required: true
    - name: api-projects-id-user-stats-prediction
      path: /api/projects/{id}/user-stats/prediction
      operations:
      - name: userspredictionagreement
        method: GET
        description: ✨ Get prediction agreement statistics for multiple annotators
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
        - name: ids
          in: query
          type: string
          description: Comma separated list of annotator user IDs to get agreement scores for
          required: true
        - name: per_label
          in: query
          type: boolean
          description: Per label
        - name: Authorization
          in: header
          type: string
          description: 'The token (or API key) must be passed as a request header. You can find your user token on the User
            Account page in Label Studio. Example: <br><pre><code class='
          required: true
    - name: api-projects-id-user-stats-review_score
      path: /api/projects/{id}/user-stats/review_score
      operations:
      - name: usersreviewscore
        method: GET
        description: ✨ Get review scores for multiple annotators
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
        - name: ids
          in: query
          type: string
          description: Comma separated list of annotator user IDs to get review scores for
          required: true
        - name: per_label
          in: query
          type: boolean
          description: Per label
        - name: Authorization
          in: header
          type: string
          description: 'The token (or API key) must be passed as a request header. You can find your user token on the User
            Account page in Label Studio. Example: <br><pre><code class='
          required: true
    - name: api-projects-id-user-stats-user_pk-prediction
      path: /api/projects/{id}/user-stats/{user_pk}/prediction
      operations:
      - name: userpredictionagreement
        method: GET
        description: ✨ Get individual user prediction agreement
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
        - name: user_pk
          in: path
          type: integer
          required: true
        - name: per_label
          in: query
          type: boolean
          description: Calculate agreement per label
        - name: Authorization
          in: header
          type: string
          description: 'The token (or API key) must be passed as a request header. You can find your user token on the User
            Account page in Label Studio. Example: <br><pre><code class='
          required: true
    - name: api-projects-id-user-stats-user_pk-review_score
      path: /api/projects/{id}/user-stats/{user_pk}/review_score
      operations:
      - name: userreviewscore
        method: GET
        description: ✨ Get individual user review scores
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
        - name: user_pk
          in: path
          type: integer
          required: true
        - name: per_label
          in: query
          type: boolean
          description: Calculate agreement per label
        - name: Authorization
          in: header
          type: string
          description: 'The token (or API key) must be passed as a request header. You can find your user token on the User
            Account page in Label Studio. Example: <br><pre><code class='
          required: true
    - name: api-projects-id-users-user_pk-stats-agreement-groundtruth
      path: /api/projects/{id}/users/{user_pk}/stats/agreement-groundtruth
      operations:
      - name: usergroundtruthagreement
        method: GET
        description: ✨ Get individual user ground truth agreement
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          required: true
        - name: user_pk
          in: path
          type: integer
          required: true
        - name: per_label
          in: query
          type: boolean
          description: Calculate agreement per label
        - name: Authorization
          in: header
          type: string
          description: 'The token (or API key) must be passed as a request header. You can find your user token on the User
            Account page in Label Studio. Example: <br><pre><code class='
          required: true
    authentication:
      type: apikey
      key: Authorization
      value: '{{env.LABEL_STUDIO_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: label-studio-subpackage-projects-subpackage-projects-stats-rest
    port: 8080
    description: REST adapter for API Reference — subpackage_projects.subpackage_projects/stats. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/api/projects/{id}/model-stats/{model-version}/agreement
      name: api-projects-id-model-stats-model-version-agreement
      description: REST surface for api-projects-id-model-stats-model_version-agreement.
      operations:
      - method: GET
        name: modelversionannotatoragreement
        description: ✨ Get model-version overall agreement vs annotators
        call: label-studio-subpackage-projects-subpackage-projects-stats.modelversionannotatoragreement
        with:
          id: rest.id
          model_version: rest.model_version
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{id}/model-stats/{model-version}/agreement-groundtruth
      name: api-projects-id-model-stats-model-version-agreement-groundtruth
      description: REST surface for api-projects-id-model-stats-model_version-agreement-groundtruth.
      operations:
      - method: GET
        name: modelversiongroundtruthagreement
        description: ✨ Get model-version ground truth agreement
        call: label-studio-subpackage-projects-subpackage-projects-stats.modelversiongroundtruthagreement
        with:
          id: rest.id
          model_version: rest.model_version
          per_label: rest.per_label
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{id}/model-stats/{model-version}/prediction
      name: api-projects-id-model-stats-model-version-prediction
      description: REST surface for api-projects-id-model-stats-model_version-prediction.
      operations:
      - method: GET
        name: modelversionpredictionagreement
        description: ✨ Get model-version prediction agreement
        call: label-studio-subpackage-projects-subpackage-projects-stats.modelversionpredictionagreement
        with:
          id: rest.id
          model_version: rest.model_version
          per_label: rest.per_label
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{id}/stats/iaa
      name: api-projects-id-stats-iaa
      description: REST surface for api-projects-id-stats-IAA.
      operations:
      - method: GET
        name: iaa
        description: ✨ Get Inter-Annotator Agreement matrix
        call: label-studio-subpackage-projects-subpackage-projects-stats.iaa
        with:
          id: rest.id
          expand: rest.expand
          per_label: rest.per_label
          std: rest.std
          task: rest.task
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{id}/stats/agreement-groundtruth
      name: api-projects-id-stats-agreement-groundtruth
      description: REST surface for api-projects-id-stats-agreement-groundtruth.
      operations:
      - method: GET
        name: usersgroundtruthagreement
        description: ✨ Get ground truth agreement for multiple users
        call: label-studio-subpackage-projects-subpackage-projects-stats.usersgroundtruthagreement
        with:
          id: rest.id
          ids: rest.ids
          per_label: rest.per_label
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{id}/stats/agreement-annotator/{user-id}
      name: api-projects-id-stats-agreement-annotator-user-id
      description: REST surface for api-projects-id-stats-agreement_annotator-user_id.
      operations:
      - method: GET
        name: agreementannotator
        description: ✨ Get individual annotator agreement stats
        call: label-studio-subpackage-projects-subpackage-projects-stats.agreementannotator
        with:
          id: rest.id
          user_id: rest.user_id
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{id}/stats/agreement-annotators
      name: api-projects-id-stats-agreement-annotators
      description: REST surface for api-projects-id-stats-agreement_annotators.
      operations:
      - method: GET
        name: agreementannotators
        description: ✨ Get agreement statistics for multiple annotators
        call: label-studio-subpackage-projects-subpackage-projects-stats.agreementannotators
        with:
          id: rest.id
          ids: rest.ids
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{id}/stats/data-filter
      name: api-projects-id-stats-data-filter
      description: REST surface for api-projects-id-stats-data_filter.
      operations:
      - method: GET
        name: datafilters
        description: ✨ Get user data filter statistics
        call: label-studio-subpackage-projects-subpackage-projects-stats.datafilters
        with:
          id: rest.id
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{id}/stats/finished
      name: api-projects-id-stats-finished
      description: REST surface for api-projects-id-stats-finished.
      operations:
      - method: GET
        name: finishedtasks
        description: ✨ Get finished tasks statistics
        call: label-studio-subpackage-projects-subpackage-projects-stats.finishedtasks
        with:
          id: rest.id
          user_pk: rest.user_pk
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{id}/stats/label-distribution/counts
      name: api-projects-id-stats-label-distribution-counts
      description: REST surface for api-projects-id-stats-label-distribution-counts.
      operations:
      - method: GET
        name: labeldistributioncounts
        description: ✨ Get label distribution counts
        call: label-studio-subpackage-projects-subpackage-projects-stats.labeldistributioncounts
        with:
          id: rest.id
          choice_keys: rest.choice_keys
          limit: rest.limit
          offset: rest.offset
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{id}/stats/label-distribution/structure
      name: api-projects-id-stats-label-distribution-structure
      description: REST surface for api-projects-id-stats-label-distribution-structure.
      operations:
      - method: GET
        name: labeldistributionstructure
        description: ✨ Get label distribution structure
        call: label-studio-subpackage-projects-subpackage-projects-stats.labeldistributionstructure
        with:
          id: rest.id
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{id}/stats/lead-time
      name: api-projects-id-stats-lead-time
      description: REST surface for api-projects-id-stats-lead_time.
      operations:
      - method: GET
        name: leadtime
        description: ✨ Get lead time statistics
        call: label-studio-subpackage-projects-subpackage-projects-stats.leadtime
        with:
          id: rest.id
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{id}/stats/member-performance-rows
      name: api-projects-id-stats-member-performance-rows
      description: REST surface for api-projects-id-stats-member_performance_rows.
      operations:
      - method: GET
        name: memberperformancerows
        description: ✨ Get paginated member performance rows
        call: label-studio-subpackage-projects-subpackage-projects-stats.memberperformancerows
        with:
          id: rest.id
          ids: rest.ids
          ordering: rest.ordering
          page: rest.page
          page_size: rest.page_size
          table: rest.table
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{id}/stats/total-agreement
      name: api-projects-id-stats-total-agreement
      description: REST surface for api-projects-id-stats-total_agreement.
      operations:
      - method: GET
        name: totalagreement
        description: ✨ Get total agreement for project
        call: label-studio-subpackage-projects-subpackage-projects-stats.totalagreement
        with:
          id: rest.id
          per_label: rest.per_label
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{id}/update-stats
      name: api-projects-id-update-stats
      description: REST surface for api-projects-id-update-stats.
      operations:
      - method: GET
        name: updatestats
        description: ✨ Start stats recalculation
        call: label-studio-subpackage-projects-subpackage-projects-stats.updatestats
        with:
          id: rest.id
          stat_type: rest.stat_type
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{id}/user-stats/prediction
      name: api-projects-id-user-stats-prediction
      description: REST surface for api-projects-id-user-stats-prediction.
      operations:
      - method: GET
        name: userspredictionagreement
        description: ✨ Get prediction agreement statistics for multiple annotators
        call: label-studio-subpackage-projects-subpackage-projects-stats.userspredictionagreement
        with:
          id: rest.id
          ids: rest.ids
          per_label: rest.per_label
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{id}/user-stats/review-score
      name: api-projects-id-user-stats-review-score
      description: REST surface for api-projects-id-user-stats-review_score.
      operations:
      - method: GET
        name: usersreviewscore
        description: ✨ Get review scores for multiple annotators
        call: label-studio-subpackage-projects-subpackage-projects-stats.usersreviewscore
        with:
          id: rest.id
          ids: rest.ids
          per_label: rest.per_label
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{id}/user-stats/{user-pk}/prediction
      name: api-projects-id-user-stats-user-pk-prediction
      description: REST surface for api-projects-id-user-stats-user_pk-prediction.
      operations:
      - method: GET
        name: userpredictionagreement
        description: ✨ Get individual user prediction agreement
        call: label-studio-subpackage-projects-subpackage-projects-stats.userpredictionagreement
        with:
          id: rest.id
          user_pk: rest.user_pk
          per_label: rest.per_label
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{id}/user-stats/{user-pk}/review-score
      name: api-projects-id-user-stats-user-pk-review-score
      description: REST surface for api-projects-id-user-stats-user_pk-review_score.
      operations:
      - method: GET
        name: userreviewscore
        description: ✨ Get individual user review scores
        call: label-studio-subpackage-projects-subpackage-projects-stats.userreviewscore
        with:
          id: rest.id
          user_pk: rest.user_pk
          per_label: rest.per_label
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{id}/users/{user-pk}/stats/agreement-groundtruth
      name: api-projects-id-users-user-pk-stats-agreement-groundtruth
      description: REST surface for api-projects-id-users-user_pk-stats-agreement-groundtruth.
      operations:
      - method: GET
        name: usergroundtruthagreement
        description: ✨ Get individual user ground truth agreement
        call: label-studio-subpackage-projects-subpackage-projects-stats.usergroundtruthagreement
        with:
          id: rest.id
          user_pk: rest.user_pk
          per_label: rest.per_label
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: label-studio-subpackage-projects-subpackage-projects-stats-mcp
    port: 9090
    transport: http
    description: MCP adapter for API Reference — subpackage_projects.subpackage_projects/stats. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: get-model-version-overall-agreement
      description: ✨ Get model-version overall agreement vs annotators
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: label-studio-subpackage-projects-subpackage-projects-stats.modelversionannotatoragreement
      with:
        id: tools.id
        model_version: tools.model_version
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: get-model-version-ground-truth
      description: ✨ Get model-version ground truth agreement
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: label-studio-subpackage-projects-subpackage-projects-stats.modelversiongroundtruthagreement
      with:
        id: tools.id
        model_version: tools.model_version
        per_label: tools.per_label
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: get-model-version-prediction-agreement
      description: ✨ Get model-version prediction agreement
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: label-studio-subpackage-projects-subpackage-projects-stats.modelversionpredictionagreement
      with:
        id: tools.id
        model_version: tools.model_version
        per_label: tools.per_label
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: get-inter-annotator-agreement-matrix
      description: ✨ Get Inter-Annotator Agreement matrix
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: label-studio-subpackage-projects-subpackage-projects-stats.iaa
      with:
        id: tools.id
        expand: tools.expand
        per_label: tools.per_label
        std: tools.std
        task: tools.task
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: get-ground-truth-agreement-multiple
      description: ✨ Get ground truth agreement for multiple users
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: label-studio-subpackage-projects-subpackage-projects-stats.usersgroundtruthagreement
      with:
        id: tools.id
        ids: tools.ids
        per_label: tools.per_label
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: get-individual-annotator-agreement-stats
      description: ✨ Get individual annotator agreement stats
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: label-studio-subpackage-projects-subpackage-projects-stats.agreementannotator
      with:
        id: tools.id
        user_id: tools.user_id
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: get-agreement-statistics-multiple-annotators
      description: ✨ Get agreement statistics for multiple annotators
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: label-studio-subpackage-projects-subpackage-projects-stats.agreementannotators
      with:
        id: tools.id
        ids: tools.ids
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: get-user-data-filter-statistics
      description: ✨ Get user data filter statistics
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: label-studio-subpackage-projects-subpackage-projects-stats.datafilters
      with:
        id: tools.id
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: get-finished-tasks-statistics
      description: ✨ Get finished tasks statistics
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: label-studio-subpackage-projects-subpackage-projects-stats.finishedtasks
      with:
        id: tools.id
        user_pk: tools.user_pk
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: get-label-distribution-counts
      description: ✨ Get label distribution counts
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: label-studio-subpackage-projects-subpackage-projects-stats.labeldistributioncounts
      with:
        id: tools.id
        choice_keys: tools.choice_keys
        limit: tools.limit
        offset: tools.offset
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: get-label-distribution-structure
      description: ✨ Get label distribution structure
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: label-studio-subpackage-projects-subpackage-projects-stats.labeldistributionstructure
      with:
        id: tools.id
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: get-lead-time-statistics
      description: ✨ Get lead time statistics
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: label-studio-subpackage-projects-subpackage-projects-stats.leadtime
      with:
        id: tools.id
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: get-paginated-member-performance-rows
      description: ✨ Get paginated member performance rows
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: label-studio-subpackage-projects-subpackage-projects-stats.memberperformancerows
      with:
        id: tools.id
        ids: tools.ids
        ordering: tools.ordering
        page: tools.page
        page_size: tools.page_size
        table: tools.table
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: get-total-agreement-project
      description: ✨ Get total agreement for project
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: label-studio-subpackage-projects-subpackage-projects-stats.totalagreement
      with:
        id: tools.id
        per_label: tools.per_label
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: start-stats-recalculation
      description: ✨ Start stats recalculation
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: label-studio-subpackage-projects-subpackage-projects-stats.updatestats
      with:
        id: tools.id
        stat_type: tools.stat_type
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: get-prediction-agreement-statistics-multiple
      description: ✨ Get prediction agreement statistics for multiple annotators
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: label-studio-subpackage-projects-subpackage-projects-stats.userspredictionagreement
      with:
        id: tools.id
        ids: tools.ids
        per_label: tools.per_label
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: get-review-scores-multiple-annotators
      description: ✨ Get review scores for multiple annotators
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: label-studio-subpackage-projects-subpackage-projects-stats.usersreviewscore
      with:
        id: tools.id
        ids: tools.ids
        per_label: tools.per_label
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: get-individual-user-prediction-agreement
      description: ✨ Get individual user prediction agreement
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: label-studio-subpackage-projects-subpackage-projects-stats.userpredictionagreement
      with:
        id: tools.id
        user_pk: tools.user_pk
        per_label: tools.per_label
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: get-individual-user-review-scores
      description: ✨ Get individual user review scores
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: label-studio-subpackage-projects-subpackage-projects-stats.userreviewscore
      with:
        id: tools.id
        user_pk: tools.user_pk
        per_label: tools.per_label
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: get-individual-user-ground-truth
      description: ✨ Get individual user ground truth agreement
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: label-studio-subpackage-projects-subpackage-projects-stats.usergroundtruthagreement
      with:
        id: tools.id
        user_pk: tools.user_pk
        per_label: tools.per_label
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.