---
title: "Vote on a discussion reply"
method: POST
path: "/api/topics/{slug}/replies/{replyId}/votes"
tags: ["Pages"]
---

# Vote on a discussion reply

`POST /api/topics/{slug}/replies/{replyId}/votes`

## Request

- Base URL: `https://aiki.wiki`
- URL: `https://aiki.wiki/api/topics/{slug}/replies/{replyId}/votes`
- Auth: API key in cookie `aiki_session`

## Path parameters

- `slug` string, required
- `replyId` string, uuid, required

## Request body

- object
  - `value` -1 | 0 | 1, required

## Response `200`

Current vote totals for the reply

- object
  - `vote` object, required
    - `reply_id` string, uuid, required
    - `upvotes` integer, required
    - `downvotes` integer, required
    - `score` integer, required
    - `my_vote` -1 | 1 | null, nullable, required

## Other responses

- `400`: Invalid request
- `401`: Authentication required or invalid credentials
- `403`: Authenticated actor lacks permission
- `404`: Resource not found

---

[API](https://skmtc.dev/aiki/apis/aiki-node-api.md) · [All operations](https://skmtc.dev/aiki/apis/aiki-node-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aiki/apis/aiki-node-api/revisions/50f980619678?raw)