Sprints

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 sprints son iteraciones con tiempo limitado que se utilizan para planificar y entregar trabajo. Cada sprint contiene tareas y proporciona métricas integradas para rastrear velocidad, burndown y rendimiento del equipo.

Listar sprints

Devuelve los sprints de un proyecto.

GET /sprints?company_slug={slug}&project_slug={slug}

Parámetros de query

Ejemplo de solicitud

curl -X GET "https://services.gitscrum.com/sprints?company_slug=acme&project_slug=web-app" \
  -H "Authorization: Bearer {token}"

Ejemplo de respuesta

{
  "data": [
    {
      "slug": "sprint-12",
      "title": "Sprint 12",
      "description": "Authentication and onboarding improvements",
      "date_start": "2026-02-03",
      "date_finish": "2026-02-14",
      "color": "4A90D9",
      "is_private": false,
      "close_on_finish": true,
      "stats": {
        "tasks_count": 18,
        "completed_count": 7,
        "progress_percentage": 39
      }
    }
  ]
}

Obtener sprint

Devuelve los detalles completos de un sprint individual.

GET /sprints/{slug}?company_slug={slug}&project_slug={slug}

Parámetros de ruta

Todos los sprints (Cross-Workspace)

Devuelve sprints en todos los workspaces a los que el usuario autenticado tiene acceso.

GET /sprints/all-workspaces

Crear sprint

Crea un nuevo sprint.

POST /sprints

Cuerpo de la solicitud

Ejemplo de solicitud

curl -X POST "https://services.gitscrum.com/sprints" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Sprint 13",
    "company_slug": "acme",
    "project_slug": "web-app",
    "date_start": "2026-02-17",
    "date_finish": "2026-02-28",
    "close_on_finish": true
  }'

Actualizar sprint

Actualiza un sprint existente.

PUT /sprints/{slug}

Cuerpo de la solicitud

Acepta companyslug, projectslug y los mismos campos opcionales que Crear sprint.

KPIs del sprint

Devuelve los indicadores clave de rendimiento del sprint.

GET /sprints/{slug}/kpis?company_slug={slug}&project_slug={slug}

Estadísticas del sprint

Devuelve estadísticas del sprint.

GET /sprints/{slug}/stats?company_slug={slug}&project_slug={slug}

Informes del sprint

Devuelve informes del sprint con datos de gráficos opcionales.

GET /sprints/{slug}/reports?company_slug={slug}&project_slug={slug}

Parámetros de query

Progreso del sprint

Devuelve el progreso actual del sprint.

GET /sprints/{slug}/progress?company_slug={slug}&project_slug={slug}

Métricas del sprint

Devuelve métricas detalladas del sprint.

GET /sprints/{slug}/metrics?company_slug={slug}&project_slug={slug}

Eliminar sprint

Elimina permanentemente un sprint. Las tareas del sprint se conservan pero se desvinculan.

DELETE /sprints/{slug}?company_slug={slug}&project_slug={slug}

Parámetros de ruta

Referencia de campos