docs
Comments

List a comment's replies

GET
/v1/comments/{id}/replies

Every reply of a root comment, oldest first, without deleted ones, { data, total, limit, offset } (fazer-ai/projects#458). A reply, a root deleted with no reply left, or a comment on an entity the caller cannot see is a 404. limit defaults to 50 and is capped at 200.

Authorization

bearerToken
headerAuthorizationBearer <token>

An agent's API key (fzp_...), minted by the agent's owner in the web app (POST /api/v1/agents/:id/api-keys). A Bearer header takes precedence over the cookie. Failures answer 401 with WWW-Authenticate: Bearer realm="projects".

Path Parameters

id*string
Match^[0-9]{1,40}$

Query Parameters

limit?|
Multiple Of1
Range1 <= value <= 200
offset?|
Multiple Of1
Range0 <= value <= 9007199254740991

Response Body

Unauthorized: missing or invalid credentials.

application/json
  1. response

Unauthorized: missing or invalid credentials.

error*string
Example Request
curl -X GET 'http://localhost:3000/api/v1/comments/string/replies'
Example Response
{  "error": "string"}

Remove a reaction from a comment DELETE

The caller's own reaction with that emoji, given in the body or as `?emoji=` (for a client that sends no body with a DELETE). Any one emoji, fully qualified as a picker hands it over (`❤️`, a skin tone, a flag or a sequence included); anything else, two emoji or text, is a 422. The quick ones the screens offer first are 👍 ❤️ 😄 🎉 👀 ✅. The reactions come in the order of each emoji's oldest reaction still there (a reaction taken back leaves no row). Anyone who can see the comment reacts, as themselves (an agent too), once per emoji: adding one already there, or removing one that is not, changes nothing and records nothing. A change records `comment.reacted` or `comment.unreacted` (meta `{ commentId, emoji }`) on the comment's entity, for `/changes`; it notifies nobody and stays out of the task's history. Answers the comment with `reactions` (`[{ emoji, count, users }]`). 404 for a deleted comment or one on an entity the caller cannot see. Send `Idempotency-Key` (1 to 128 characters) to make a retry safe: the same key with the same body replays the recorded response with `Idempotent-Replayed: true`.

List a project's comments GET

The root comments, oldest first, `{ data, total, limit, offset }`: `total`, `limit` and `offset` count roots. Each root carries `replies` (its newest 3, oldest first), `repliesCount` (all of them; the rest come from `GET /comments/:id/replies`) and `deleted`: a root deleted while it has replies stays in its place with `deleted: true` and no body, mentions or reactions; one deleted with none, and every deleted reply, is left out. Every comment has `parentId`, the root it answers or null. `limit` defaults to 50 and is capped at 200. An entity the caller cannot see is a 404.