---
title: "Create Qualification Item"
method: POST
path: "/api/v1/quality/rankings/{ranking_id}/qualification-items"
tags: ["Annotator Qualification"]
---

# Create Qualification Item

`POST /api/v1/quality/rankings/{ranking_id}/qualification-items`

## Request

- Base URL: `https://app.aimrank.io` (the document declares no server; this is the origin it was published from)
- URL: `https://app.aimrank.io/api/v1/quality/rankings/{ranking_id}/qualification-items`
- Auth: none declared

Create a gold-standard qualification item. Owner-only.

## Path parameters

- `ranking_id` string, required

## Request body

- QualificationItemCreate
  - `entity_a_id` string, required: One of the entities being compared
  - `entity_b_id` string, required: The other entity
  - `expected_winner_id` string, required: The canonically-correct winner (must be entity_a_id or entity_b_id)
  - `rationale` string, nullable

## Response `201`

Successful Response

- QualificationItemResponse
  - `id` string, required
  - `ranking_id` string, required
  - `entity_a_id` string, required
  - `entity_b_id` string, required
  - `expected_winner_id` string, nullable
  - `rationale` string, nullable
  - `is_active` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aimrank/apis/aimrank-api.md) · [All operations](https://skmtc.dev/aimrank/apis/aimrank-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aimrank/apis/aimrank-api/revisions/3574d0aff459?raw)