Comentarios

El hilo de conversación de cada tarea. Los comentarios creados por API llevan como autor el nombre de la key — identificables a simple vista en la app.

Listar comentarios

GET/api/v1/tasks/{taskId}/commentsLectura (cualquier key)

El hilo completo de una tarea, del más antiguo al más nuevo.

Request
curl https://planely.dev/api/v1/tasks/9b2f6c3a-…/comments \
  -H "Authorization: Bearer $PLANELY_API_KEY"
200 OK
{
  "comments": [
    {
      "id": "5cc2…",
      "taskId": "9b2f…",
      "body": "Desplegado en staging ✅",
      "author": { "id": "a1b2…", "name": "Marta" },
      "authorName": "Marta",
      "createdAt": "2026-07-25T11:40:12.000Z",
      "updatedAt": "2026-07-25T11:40:12.000Z"
    }
  ]
}

Comentar una tarea

POST/api/v1/tasks/{taskId}/commentsPermiso: Editar tareas

Texto plano, hasta 5000 caracteres. El autor será la key («mi-key (API)»); las @menciones son un concepto de la app y no se procesan aquí.

Cuerpo (JSON)

  • bodystringobligatorio

    1–5000 caracteres

Request
curl -X POST https://planely.dev/api/v1/tasks/9b2f6c3a-…/comments \
  -H "Authorization: Bearer $PLANELY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "body": "Build nocturna en verde." }'
201 Created
{ "comment": { "id": "7de1…", "author": null, "authorName": "ci-bot (API)",} }