Skip to main content
GET
/
api
/
v1
/
skills
/
{id}
/
reviews
Skill Reviews
curl --request GET \
  --url https://api.example.com/api/v1/skills/{id}/reviews \
  --header 'Content-Type: application/json' \
  --data '
{
  "rating": 123,
  "body": "<string>"
}
'
Get user reviews for a skill, or submit your own rating.

​
Authentication

Requires a Bearer token. See Authentication.

​
Path Parameters

​
id
string
required
The skill UUID.

​
List Reviews (GET)

curl https://www.hitheo.ai/api/v1/skills/skill_abc123/reviews \
  -H "Authorization: Bearer $THEO_API_KEY"
Returns an array of review objects with rating (1–5), body, authorUserId, and createdAt.

​
Submit a Review (POST)

​
rating
integer
required
Rating from 1 to 5.
​
body
string
Review text (max 2,000 characters).
curl -X POST https://www.hitheo.ai/api/v1/skills/skill_abc123/reviews \
  -H "Authorization: Bearer $THEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rating": 5, "body": "Great skill, saves hours of work!"}'

​
Endpoint

GET /api/v1/skills/{id}/reviews Requires authentication via Bearer token. See Authentication.