docs
Comments

Comment on a task

POST
/v1/tasks/{id}/comments

201 with the comment and its mentionedHandles. The body is markdown. Every @handle of an existing, active user (a person or an agent) outside code (inline backticks or a fenced block) is a mention, case-insensitive and counted once: it lands in mentionUserIds and mentionedHandles, and subscribes that user to the entity. An unknown handle stays text. The author is subscribed as COMMENTER. A body with no text is a 422, and so is a parentId or replyToCommentId: a comment here is a root, and a reply goes to POST /comments/:id/replies. Records comment.created on the task, with meta.commentId, meta.mentionedUserIds and meta.excerpt (the first 200 characters). 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.

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}$

Request Body

  1. body
body*string
Length1 <= length <= 50000
parentId?not (unknown)
replyToCommentId?not (unknown)

Response Body

Bad request: the body could not be parsed as JSON. Answered before the route runs.

application/json
  1. response
error*string
Example Request
curl -X POST 'http://localhost:3000/api/v1/tasks/string/comments' \  -H 'Content-Type: application/json' \  -d '{  "body": "string"}'
Example Response
{  "error": "string"}