API Reference
Comments
List and create comments on feedback items.
List comments
Returns all comments on a feedback item, ordered by creation date (oldest first).
GET /api/v1/feedback/:id/commentsPath parameters
| Parameter | Type | Description |
|---|---|---|
id | string | Feedback ID |
Response
{
"data": [
{
"id": "comment-001",
"feedback_id": "fb-001",
"user_id": "user-001",
"content": "I can reproduce this on Safari 17.2",
"author": "Alex Johnson",
"created_at": "2025-06-20T15:00:00Z"
},
{
"id": "comment-002",
"feedback_id": "fb-001",
"user_id": "user-002",
"content": "Fixed in commit abc123, deploying now",
"author": "Sam Lee",
"created_at": "2025-06-21T09:30:00Z"
}
],
"meta": { "total": 2, "limit": 100, "offset": 0 }
}Fields
| Field | Type | Description |
|---|---|---|
id | string | Comment ID |
feedback_id | string | Parent feedback ID |
user_id | string | Author's user ID |
content | string | Comment text |
author | string | null | Author's display name |
created_at | string | ISO 8601 timestamp |
Errors
| Status | Error |
|---|---|
404 | Feedback not found |
Create comment
Add a comment to a feedback item. The comment is attributed to the token owner.
POST /api/v1/feedback/:id/commentsPath parameters
| Parameter | Type | Description |
|---|---|---|
id | string | Feedback ID |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
content | string | Yes | Comment text. Supports @DisplayName mentions |
Mentions
Include @DisplayName anywhere in the comment content to tag a team member. The API automatically resolves display names to user IDs and records the mention. Tagged users will receive a notification.
Use the project members endpoint to look up valid display names.
# Comment with a mention
curl -X POST \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"content": "@Alex Johnson can you reproduce this on Safari?"}' \
https://loop.solve-studio.co/api/v1/feedback/fb-001/commentsExample
curl -X POST \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"content": "Investigating this issue now"}' \
https://loop.solve-studio.co/api/v1/feedback/fb-001/commentsResponse
{
"data": {
"id": "comment-003",
"feedback_id": "fb-001",
"user_id": "user-001",
"content": "Investigating this issue now",
"created_at": "2025-06-21T10:00:00Z"
}
}Errors
| Status | Error |
|---|---|
400 | content is required |
404 | Feedback not found |