Tipos de Tarea

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 tipos de tarea categorizan las tareas dentro de un proyecto — como Feature, Bug, Improvement o cualquier tipo personalizado que definas. Cada tipo tiene un color para identificación visual en el tablero.

Listar tipos de tarea

Devuelve los tipos de tarea disponibles para un proyecto.

GET /project-templates/type?company_slug={slug}&project_slug={slug}

Parámetros de query

Ejemplo de solicitud

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

Ejemplo de respuesta

{
  "data": [
    {
      "id": 1,
      "title": "Feature",
      "color": "4A90D9",
      "position": 1
    },
    {
      "id": 2,
      "title": "Bug",
      "color": "E74C3C",
      "position": 2
    },
    {
      "id": 3,
      "title": "Improvement",
      "color": "F39C12",
      "position": 3
    }
  ]
}

Crear tipo de tarea

Crea un nuevo tipo de tarea en el proyecto.

POST /project-templates/type?company_slug={slug}&project_slug={slug}

Cuerpo de la solicitud

Ejemplo de solicitud

curl -X POST "https://services.gitscrum.com/project-templates/type?company_slug=acme&project_slug=web-app" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Chore",
    "color": "9B59B6"
  }'

Actualizar tipo de tarea

Actualiza un tipo de tarea existente.

PUT /project-templates/type/{id}?company_slug={slug}&project_slug={slug}

Parámetros de ruta

Cuerpo de la solicitud

Listar niveles de esfuerzo

Devuelve los niveles de esfuerzo/prioridad configurados para el proyecto.

GET /project-templates/effort?company_slug={slug}&project_slug={slug}

Ejemplo de respuesta

{
  "data": [
    {
      "id": 1,
      "title": "Low",
      "color": "27AE60",
      "position": 1
    },
    {
      "id": 2,
      "title": "Medium",
      "color": "F39C12",
      "position": 2
    },
    {
      "id": 3,
      "title": "High",
      "color": "E74C3C",
      "position": 3
    }
  ]
}

Referencia de campos