---
title: "Cast Binary Vote"
method: POST
path: "/api/v1/votes/binary"
tags: ["Votes"]
---

# Cast Binary Vote

`POST /api/v1/votes/binary`

## 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/votes/binary`
- Auth: none declared

Cast a binary label (True/False) on a single entity.

Mirrors POST /votes for the pairwise primitive. Used for tasks
where pairing items is artificial: moderation, fact-checking,
dataset cleanup, "is this safe?" / "is this on-brand?". The
ranking must have `vote_type='binary'`.

Stored shape: outcome='binary', label=True/False, entity_a_id is
the labelled item, entity_b_id is NULL, winner_id is NULL.
Aggregation lives in GET /rankings/{id}/labels — wins/losses on
Entity stay zero for binary rankings; the canonical signal is the
label distribution per entity.

## Request body

- BinaryVoteCreate: Cast a binary label on a single entity in a vote_type='binary' ranking.
  - `ranking_id` string, required
  - `entity_id` string, required
  - `label` boolean, required: True if the entity passes the criterion, False otherwise
  - `decision_time_ms` integer, nullable
  - `voter_segment` object, nullable

## Response `201`

Successful Response

- unknown

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