Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/jparra-amell/api_solsql/llms.txt

Use this file to discover all available pages before exploring further.

The Comments API lets you create, read, update, and delete user comments attached to places. Each comment belongs to a place (place_id) and a user (id). You can build threaded discussions by setting parent_comment_id to the ID of an existing comment; leave it null for a top-level comment.

​
GET /api/Comments

Returns all comments in the system.

​
Response

​
comment_id
integer
Unique identifier for the comment.
​
place_id
integer
ID of the place the comment belongs to.
​
name_place
string
Display name of the place.
​
id
integer
ID of the user who posted the comment.
​
name
string
Display name of the user.
​
comment
string
The comment text.
​
parent_comment_id
integer | null
ID of the parent comment if this is a reply; null for top-level comments.
​
comment_date
string (datetime)
ISO 8601 timestamp of when the comment was posted.
curl -X GET https://your-api-host/api/Comments

​
GET /api/Comments/

Returns a single comment by its ID.

​
Path parameters

​
id
integer
required
The unique ID of the comment to retrieve.

​
Response

Returns a single Comments object. See field descriptions under GET /api/Comments. 
curl -X GET https://your-api-host/api/Comments/42

​
Error codes

CodeDescription
404No comment found with the given id.
500Internal server error.

​
GET /api/Comments/byLugar/

Returns all comments for a specific place. The response uses the CommentsPlace view, which includes the commenter’s name alongside comment content. This is the recommended endpoint for displaying a comment thread on a place detail page.

​
Path parameters

​
place_id
integer
required
The ID of the place whose comments you want to retrieve.

​
Response

​
comment_id
integer
Unique identifier for the comment.
​
parent_comment_id
integer | null
ID of the parent comment for replies; null for top-level comments.
​
name
string
Display name of the user who posted the comment.
​
comment
string
The comment text.
​
comment_date
string (datetime)
ISO 8601 timestamp of when the comment was posted.
curl -X GET https://your-api-host/api/Comments/byLugar/7

​
Error codes

CodeDescription
404No comments found for the given place_id.
500Internal server error.

​
POST /api/Comments

Creates a new comment on a place. Set parent_comment_id to the ID of an existing comment to post a reply; omit it or pass null for a top-level comment.

​
Request body

​
place_id
integer
required
ID of the place to comment on.
​
id
integer
required
ID of the user posting the comment.
​
comment
string
required
The comment text.
​
parent_comment_id
integer
ID of the comment this reply is responding to. Omit or set to null for a top-level comment.
​
comment_date
string (datetime)
required
ISO 8601 timestamp representing when the comment was made.

​
Response

Returns 200 OK with a plain-text success message on success. Top-level comment 
curl -X POST https://your-api-host/api/Comments \
  -H "Content-Type: application/json" \
  -d '{
    "place_id": 7,
    "id": 3,
    "comment": "Great spot for a weekend hike!",
    "parent_comment_id": null,
    "comment_date": "2026-05-08T10:30:00Z"
  }'
Reply to an existing comment 
curl -X POST https://your-api-host/api/Comments \
  -H "Content-Type: application/json" \
  -d '{
    "place_id": 7,
    "id": 5,
    "comment": "Totally agree, the view from the top is stunning.",
    "parent_comment_id": 42,
    "comment_date": "2026-05-08T11:00:00Z"
  }'

​
Error codes

CodeDescription
500Internal server error.
The comment_date field should be provided by the client and typically reflects the time the user submitted the form.

​
PUT /api/Comments/

Updates the text of an existing comment. Only the comment field can be changed.

​
Path parameters

​
id
integer
required
The ID of the comment to update.

​
Request body

​
comment
string
required
The updated comment text.

​
Response

Returns 200 OK with a success message on update. 
curl -X PUT https://your-api-host/api/Comments/42 \
  -H "Content-Type: application/json" \
  -d '{
    "comment": "Updated: the trail is now closed on Mondays."
  }'

​
Error codes

CodeDescription
404No comment found with the given id.
500Internal server error.
Only the comment text is updatable. place_id, id (user), and comment_date are not modified by this endpoint.

​
DELETE /api/Comments/

Deletes a comment by its ID.

​
Path parameters

​
id
integer
required
The ID of the comment to delete.

​
Response

Returns 200 OK with a success message on deletion. 
curl -X DELETE https://your-api-host/api/Comments/42

​
Error codes

CodeDescription
404No comment found with the given id.
500Internal server error.
Deleting a parent comment does not automatically delete its replies. Handle orphaned replies in your application logic as needed.

Build docs developers (and LLMs) love

Get started for freeTalk to us