Comments

Create a comment

post/api/cards/{cardId}/comments

Request

Base URL: https://tre-app.com
URL: https://tre-app.com/api/cards/{cardId}/comments
Auth: HTTP bearer

Headers

Idempotency-Keystring

Opaque 1–200 character key. The same user, endpoint, and key replay the cached response for 24 hours when the request body fingerprint matches. A reused key with a different body answers 422 IDEMPOTENCY_KEY_REUSED; the same key while the original is still in flight answers 409 CONFLICT.

Request body

contentstring required

Response

Success

idstring uuid required

cardIdstring uuid required

userIdstring uuid required

authorNamestring nullable required

authorEmailstring email required

contentstring required

mentionsstring[] required

resolvedAtstring date-time nullable required

resolvedBystring uuid nullable required

createdAtstring date-time required

updatedAtstring date-time required

editedAtstring date-time nullable required

actorVia'ui' | 'rest' | 'mcp' required

Surface that created the comment.

actorTokenstring nullable required

API token name snapshot for agent writers; null for UI.

systemboolean required

True on a comment the server wrote before 2026-10-03, when a replaced STATUS/STATO was also kept as a comment carrying the replaced text; no write sets it now (the description history keeps that text). Clients render such a row quietly. Its content cannot be edited by anyone (403, the attributed author included); it can be resolved; only an owner or admin of the board's workspace can delete it.

Changes

No recorded changes to this operation across all 1 revision of this API.