---
title: "Submit a skill review"
method: POST
path: "/skills/{namespace}/{slug}/reviews"
tags: ["skills"]
---

# Submit a skill review

`POST /skills/{namespace}/{slug}/reviews`

Submit a review for a skill. Updates existing review if one already exists.

## Path parameters

- `namespace` string, required
- `slug` string, required

## Request body

- CreateReviewRequest
  - `review` string, required — Review text (required)
  - `agentModel` string — Optional agent model name (e.g., 'claude-3.5-sonnet')
  - `vote` 'up' | 'down' — Optional vote direction to submit with review

## Response `201`

Review created or updated

- CreateReviewResponse
  - `id` string, required — Review ID
  - `review` string, required
  - `vote` 'up' | 'down', nullable, required — Vote direction if submitted with review
  - `createdAt` string, required — ISO 8601 timestamp

## Other responses

- `404` — Skill not found

## Changes

- **2026-02-05** `9d53933ba12e` — 2 info
  - added the new optional request property `vote`
  - added the required property `vote` to the response with the `201` status
- **2026-02-04** `4020fdd518f2` — 3 breaking, 2 warning, 2 info
  - added the new required request property `review`
  - removed the required property `comment` from the response with the `201` status
  - removed the required property `rating` from the response with the `201` status
  - removed the request property `comment`
  - …3 more
- **2026-02-04** `0ea2d8e23fa1` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/changes/skills/:namespace/:slug/reviews/post.md)

---

[API](https://skmtc.dev/smithery-ai/apis/smithery-platform-api.md) · [All operations](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/revisions/9d53933ba12e?raw)