Comentarios

REST API — Todos los endpoints requieren autenticación mediante Bearer token. Incluye Authorization: Bearer {token} en cada solicitud. Los tokens se gestionan en Configuración de GitScrum → API. Base URL: https://services.gitscrum.com — Todas las rutas de solicitud en esta documentación son relativas a esta URL base.

Los comentarios permiten a los miembros del equipo discutir tareas, compartir actualizaciones y registrar decisiones directamente en los elementos de trabajo.

Listar comentarios

Devuelve los comentarios de una tarea específica.

GET /comments?company_slug={slug}&project_slug={slug}&task_uuid={uuid}

Parámetros de query

Ejemplo de solicitud

curl -X GET "https://services.gitscrum.com/comments?company_slug=acme&project_slug=web-app&task_uuid=a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "Authorization: Bearer {token}"

Ejemplo de respuesta

{
  "data": [
    {
      "id": 1024,
      "comment": "<p>API integration is complete. Ready for review.</p>",
      "user": {
        "username": "johndoe",
        "name": "John Doe"
      },
      "created_at": "2026-02-05T09:15:00Z",
      "updated_at": "2026-02-05T09:15:00Z"
    }
  ]
}

Crear comentario

Agrega un comentario a una tarea.

POST /comments

Cuerpo de la solicitud

Ejemplo de solicitud

curl -X POST "https://services.gitscrum.com/comments" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "comment": "Blocked by missing API credentials. Reaching out to DevOps.",
    "company_slug": "acme",
    "project_slug": "web-app",
    "task_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }'

Actualizar comentario

Actualiza un comentario existente.

PUT /comments/{id}

Parámetros de ruta

Cuerpo de la solicitud

Eliminar comentario

Elimina un comentario.

DELETE /comments/{id}?company_slug={slug}&project_slug={slug}

Parámetros de ruta

Referencia de campos