---
title: "Vote on a readable topic"
method: POST
path: "/api/topics/{slug}/votes"
tags: ["Pages"]
---

# Vote on a readable topic

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

## Request

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

## Path parameters

- `slug` string, required

## Request body

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

## Response `200`

Updated topic vote totals

- object

## Other responses

- `400`: Invalid request
- `401`: Authentication required or invalid credentials
- `404`: Resource not found
- `429`: Rate limit exceeded

---

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