Épicas

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.

Las épicas son iniciativas de alto nivel que agrupan historias de usuario relacionadas. Usa épicas para organizar grandes funcionalidades o fases de proyecto que abarcan múltiples sprints.

Listar épicas

Devuelve las épicas de un proyecto.

GET /user-story-epics?company_slug={slug}&project_slug={slug}

Parámetros de query

Ejemplo de solicitud

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

Ejemplo de respuesta

{
  "data": [
    {
      "uuid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
      "title": "User Onboarding",
      "description": "Complete onboarding flow including signup, verification, and tutorial.",
      "color": "8E44AD",
      "user_stories_count": 4,
      "created_at": "2026-01-10T12:00:00Z"
    }
  ]
}

Crear épica

Crea una nueva épica.

POST /user-story-epics

Cuerpo de la solicitud

Ejemplo de solicitud

curl -X POST "https://services.gitscrum.com/user-story-epics" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Billing & Payments",
    "company_slug": "acme",
    "project_slug": "web-app",
    "description": "All billing, subscription, and payment-related stories.",
    "color": "E67E22"
  }'

Actualizar épica

Actualiza una épica existente.

PUT /user-story-epics/{uuid}

Parámetros de ruta

Cuerpo de la solicitud

Eliminar épica

Elimina permanentemente una épica. Las historias de usuario vinculadas a esta épica se conservan pero se desvinculan.

DELETE /user-story-epics/{uuid}?company_slug={slug}&project_slug={slug}

Parámetros de ruta

Referencia de campos