API: Comentarios

Los comentarios son hilos de conversación sobre una tarea. Todos los miembros del espacio de trabajo pueden leerlos y escribirlos; las reacciones con emoji son por usuario y por emoji.

Listar comentarios

GET /api/workspaces/{workspaceId}/tasks/{taskId}/comments

Devuelve los comentarios de la tarea, los más recientes primero:

[
  {
    "id": "019f8a12-…",
    "body": "Looks good — ship it.",
    "author": {
      "userId": "019f7488-…",
      "firstName": "Ada",
      "lastName": "Lovelace",
      "avatarUrl": "/api/avatars/019f7488-…?v=…",
      "inactive": false
    },
    "createdAt": "2026-07-22T09:50:16Z",
    "reactions": [
      { "emoji": "👍", "count": 2, "mine": true }
    ]
  }
]

reactions está agregado por emoji; mine es true cuando el usuario que hace la llamada reaccionó con ese emoji. author.inactive marca contenido cuyo autor eliminó su cuenta — los clientes muestran una etiqueta localizada de “Usuario inactivo”.

Escribir un comentario

POST /api/workspaces/{workspaceId}/tasks/{taskId}/comments

{ "body": "Looks good — ship it." }

Devuelve 201 con { "id": "…" }. El cuerpo no puede estar vacío y está limitado a 2000 caracteres (400 en caso contrario).

Eliminar un comentario

DELETE /api/workspaces/{workspaceId}/tasks/{taskId}/comments/{commentId}

Devuelve 204. Solo el autor del comentario y el propietario del espacio de trabajo pueden eliminarlo (403 en caso contrario).

Reaccionar / quitar una reacción

PUT    /api/workspaces/{workspaceId}/tasks/{taskId}/comments/{commentId}/reactions/{emoji}
DELETE /api/workspaces/{workspaceId}/tasks/{taskId}/comments/{commentId}/reactions/{emoji}

PUT establece la reacción del usuario que hace la llamada, DELETE la quita; ambos son idempotentes y devuelven 204. El segmento de ruta {emoji} es el propio emoji codificado para URL. Reacciones admitidas: 👍 ❤️ 😄 🎉 👀 🚀 — cualquier otra responde 400.