API: comments
GET /api/v1/comments
Section titled “GET /api/v1/comments”List Comments
SPEC-001 §6.4.4: list filtered by target.
| Parameter | In | Required | Type |
|---|---|---|---|
target_kind | query | no | object |
target_guid | query | no | object |
include_deleted | query | no | boolean |
limit | query | no | integer |
offset | query | no | integer |
POST /api/v1/comments
Section titled “POST /api/v1/comments”Create Comment
SPEC-001 §6.4.4: create comment, parse mentions, log @claude as agent_action.
DELETE /api/v1/comments/{guid}
Section titled “DELETE /api/v1/comments/{guid}”Delete Comment
SPEC-001 §6.4.4: soft-delete.
| Parameter | In | Required | Type |
|---|---|---|---|
guid | path | yes | integer |
GET /api/v1/comments/{guid}
Section titled “GET /api/v1/comments/{guid}”Get Comment
| Parameter | In | Required | Type |
|---|---|---|---|
guid | path | yes | integer |
PATCH /api/v1/comments/{guid}
Section titled “PATCH /api/v1/comments/{guid}”Patch Comment
SPEC-001 §6.4.4: PATCH only by author (or superuser).
| Parameter | In | Required | Type |
|---|---|---|---|
guid | path | yes | integer |