Tareas

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 tareas son los elementos de trabajo principales en GitScrum. Cada tarea pertenece a un proyecto y puede asignarse a usuarios, organizarse en sprints, vincularse a historias de usuario, etiquetarse y rastrearse a través de columnas Kanban.

Listar tareas (Filtrar)

Devuelve una lista paginada de tareas que coinciden con los filtros especificados.

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

Parámetros de query

Ejemplo de solicitud

curl -X GET "https://services.gitscrum.com/tasks?company_slug=acme&project_slug=web-app&status=in-progress&per_page=10" \
  -H "Authorization: Bearer {token}"

Ejemplo de respuesta

{
  "data": [
    {
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "code": "WEB-42",
      "title": "Implement user authentication",
      "slug": "implement-user-authentication",
      "description": "Add JWT-based authentication flow",
      "state": 0,
      "workflow": {
        "id": 2,
        "title": "In Progress"
      },
      "type": {
        "id": 1,
        "title": "Feature",
        "color": "4A90D9"
      },
      "effort": {
        "id": 3,
        "title": "High"
      },
      "users": [
        {
          "username": "johndoe",
          "name": "John Doe"
        }
      ],
      "labels": [],
      "settings": {
        "is_blocker": false,
        "is_bug": false,
        "is_draft": false,
        "is_archived": false
      },
      "due_date": "2026-02-15",
      "created_at": "2026-01-20T10:30:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 10,
    "total": 42
  }
}

Obtener tarea

Devuelve los detalles completos de una tarea individual.

GET /tasks/{uuid}?company_slug={slug}&project_slug={slug}

Parámetros de ruta

Obtener tarea por código

Recupera una tarea usando su código legible.

GET /tasks/by-code/{code}?company_slug={slug}&project_slug={slug}

Parámetros de ruta

Mis tareas

Devuelve las tareas asignadas al usuario autenticado en todos los workspaces.

GET /tasks/all-workspaces

Tareas de hoy

Devuelve las tareas asignadas al usuario autenticado que vencen hoy.

GET /tasks/my-today

Crear tarea

Crea una nueva tarea en el proyecto especificado.

POST /tasks

Cuerpo de la solicitud

Ejemplo de solicitud

curl -X POST "https://services.gitscrum.com/tasks" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Add password reset flow",
    "company_slug": "acme",
    "project_slug": "web-app",
    "column": "To Do",
    "type_id": 1,
    "usernames": ["johndoe"],
    "due_date": "2026-02-28",
    "estimated_minutes": 120
  }'

Ejemplo de respuesta

{
  "data": {
    "uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "code": "WEB-43",
    "title": "Add password reset flow",
    "state": 0,
    "workflow": {
      "id": 1,
      "title": "To Do"
    },
    "due_date": "2026-02-28",
    "estimated_minutes": 120,
    "created_at": "2026-02-07T14:00:00Z"
  }
}

Actualizar tarea

Actualiza una tarea existente. Soporta actualización de título, descripción, fechas, workflow, tipo, esfuerzo, sprint, historia de usuario, bloqueador, bug, borrador, archivado y campos de estimación de tiempo.

PUT /tasks/{uuid}

Cuerpo de la solicitud

Acepta los mismos campos opcionales que Crear tarea, más companyslug y projectslug.

Ejemplo de solicitud

curl -X PUT "https://services.gitscrum.com/tasks/b2c3d4e5-f6a7-8901-bcde-f12345678901" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "company_slug": "acme",
    "project_slug": "web-app",
    "column": "In Progress",
    "is_blocker": true
  }'

Eliminar tarea

Elimina permanentemente una tarea. Esta acción no se puede deshacer.

DELETE /tasks/{uuid}?company_slug={slug}&project_slug={slug}

Parámetros de ruta

curl -X DELETE "https://services.gitscrum.com/tasks/b2c3d4e5-f6a7-8901-bcde-f12345678901?company_slug=acme&project_slug=web-app" \
  -H "Authorization: Bearer {token}"

Marcar tarea como hecha

Alterna el estado de completado de una tarea.

PUT /tasks/{uuid}/done?company_slug={slug}&project_slug={slug}

Parámetros de ruta

Actualizar estimación

Actualiza los story points o estimación de una tarea.

PUT /tasks/{uuid}/estimative?company_slug={slug}&project_slug={slug}

Parámetros de ruta

Cuerpo de la solicitud

Mover al tablero

Mueve una tarea a un tablero de proyecto diferente.

PUT /tasks/{uuid}/project_board?company_slug={slug}&project_slug={slug}

Parámetros de ruta

Cuerpo de la solicitud

Duplicar tarea

Crea una copia de la tarea especificada.

POST /tasks/{uuid}/duplicate?company_slug={slug}&project_slug={slug}

Mover tarea a proyecto

Mueve una tarea a un proyecto diferente.

POST /tasks/{uuid}/move?company_slug={slug}&project_slug={slug}

Cuerpo de la solicitud

Subtareas

Listar subtareas

Devuelve las subtareas de una tarea padre.

GET /tasks/{uuid}/sub-tasks?company_slug={slug}&project_slug={slug}

Vincular subtarea

Vincula una tarea existente como subtarea.

POST /tasks/{uuid}/sub-tasks/{subtask_uuid}?company_slug={slug}&project_slug={slug}

Desvincular subtarea

Elimina la relación de subtarea sin eliminar la tarea.

DELETE /tasks/{uuid}/sub-tasks/{subtask_uuid}?company_slug={slug}&project_slug={slug}

Subtareas disponibles

Busca tareas que se pueden vincular como subtareas.

GET /tasks/{uuid}/available-subtasks?company_slug={slug}&project_slug={slug}

Tareas relacionadas

Devuelve las tareas relacionadas con la tarea especificada.

GET /tasks/{uuid}/related-tasks?company_slug={slug}&project_slug={slug}

Asignados

Asignar miembro

Asigna un usuario a una tarea.

POST /task-assignees

Cuerpo de la solicitud

Desasignar miembro

Elimina un usuario de una tarea.

DELETE /task-assignees

Cuerpo de la solicitud

Checklists

Listar checklists

Devuelve los checklists de una tarea.

GET /task-checklists?task_uuid={uuid}&company_slug={slug}&project_slug={slug}

Crear elemento de checklist

Crea un nuevo elemento de checklist. Incluye parent_id para crear un sub-elemento.

POST /task-checklists

Cuerpo de la solicitud

Actualizar elemento de checklist

Actualiza el título de un elemento de checklist.

PUT /task-checklists/{id}

Cuerpo de la solicitud

Alternar elemento de checklist

Marca un elemento de checklist como hecho o no hecho.

PUT /task-checklists/{id}/toggle

Eliminar elemento de checklist

Elimina un elemento de checklist.

DELETE /task-checklists/{id}?company_slug={slug}&project_slug={slug}

Etiquetas de tarea

Listar etiquetas de la tarea

Devuelve las etiquetas adjuntas a una tarea.

GET /task-labels?task_uuid={uuid}&company_slug={slug}&project_slug={slug}

Listar etiquetas disponibles

Devuelve las etiquetas aún no asignadas a la tarea.

GET /task-labels/not-added?task_uuid={uuid}&company_slug={slug}&project_slug={slug}

Crear y adjuntar etiqueta

Crea una nueva etiqueta y la adjunta a la tarea.

POST /task-labels

Cuerpo de la solicitud

Adjuntar etiqueta

Adjunta una etiqueta existente a una tarea.

POST /task-labels/{label_id}/attach

Cuerpo de la solicitud

Desadjuntar etiqueta

Elimina una etiqueta de una tarea.

DELETE /task-labels/{label_id}/detach

Cuerpo de la solicitud

Importar tareas

Vista previa de importación

Sube un archivo CSV y devuelve una vista previa de los datos a importar.

POST /tasks/import/preview

Cuerpo de la solicitud (multipart/form-data)

Confirmar importación

Confirma la importación y crea tareas a partir de los datos previsualizados.

POST /tasks/import/confirm

Cuerpo de la solicitud

Exportar tareas

Conteo de tareas

Devuelve el conteo total de tareas para exportación.

GET /{company_slug}/{project_slug}/tasks/count

Exportar como Excel

Descarga las tareas como archivo Excel.

GET /{company_slug}/{project_slug}/tasks/excel

Favoritos

Listar favoritos

Devuelve todas las tareas marcadas como favoritas por el usuario autenticado.

GET /favorites?company_slug={slug}

Alternar favorito

Agrega o elimina una tarea de favoritos.

POST /favorites/{task_uuid}

Cuerpo de la solicitud

Notificaciones

Devuelve las notificaciones relacionadas con tareas del usuario autenticado.

GET /tasks/notifications

Referencia de campos