---
title: "Vote"
method: PUT
path: "/v1/community-lists/{slug}/vote"
tags: ["Community Lists"]
---

# Vote

`PUT /v1/community-lists/{slug}/vote`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/v1/community-lists/{slug}/vote`
- Auth: OAuth 2 (password, token URL `/v1/auth/login`)

## Path parameters

- `slug` string, required

## Request body

- CommunityVoteIn
  - `candidate_id` integer, required
  - `referral_source` string, nullable

## Response `200`

Successful Response

- CommunityVoteOut
  - `candidate_id` integer, nullable, required
  - `voter_count` integer, required
  - `ranking_ready` boolean, required
  - `candidates` CommunityCandidateOut[], required
    - `candidate_id` integer, required
    - `product_id` integer, required
    - `name` string, required
    - `price` number, nullable, required
    - `currency` string, nullable, required
    - `store_name` string, nullable, required
    - `seller_url` string, nullable, required
    - `format_label` string, required
    - `evidence_summary` string, required
    - `vote_count` integer, required
    - `rank` integer, nullable, required
    - `available` boolean, required
    - `evidence` CommunityEvidenceOut[], required
      - `claim` string, required
      - `source_title` string, required
      - `source_url` string, required
      - `captured_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/rubenayla/apis/partle-api.md) · [All operations](https://skmtc.dev/rubenayla/apis/partle-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rubenayla/apis/partle-api/revisions/628cce2acee5?raw)