Workflows

Obtén columnas de workflow del proyecto (estados del tablero Kanban). Usa IDs de workflow para mover tareas entre columnas.

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 workflows definen las columnas del tablero Kanban de un proyecto. Cada columna representa un estado de tarea (ej., Backlog, In Progress, Done). Usa los IDs de workflow al mover tareas entre columnas.

Listar workflows

GET /projects-workflows?companyslug={slug}&projectslug={slug}

Devuelve las columnas del tablero Kanban de un proyecto.

Parámetros de query

Parámetro	Tipo	Requerido	Descripción
`company_slug`	string	Sí	Identificador del workspace
`project_slug`	string	Sí	Identificador del proyecto

curl -X GET "https://services.gitscrum.com/projects-workflows?company_slug=acme-corp&project_slug=web-platform" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json"

Respuesta 200 OK

{
  "data": [
    {
      "id": 1,
      "slug": "backlog",
      "title": "Backlog",
      "color": "#6B7280",
      "state": 0,
      "position": 1,
      "default": true
    },
    {
      "id": 2,
      "slug": "in-progress",
      "title": "In Progress",
      "color": "#3B82F6",
      "state": 0,
      "position": 2,
      "default": false
    },
    {
      "id": 3,
      "slug": "in-review",
      "title": "In Review",
      "color": "#F59E0B",
      "state": 0,
      "position": 3,
      "default": false
    },
    {
      "id": 4,
      "slug": "done",
      "title": "Done",
      "color": "#10B981",
      "state": 1,
      "position": 4,
      "default": false
    }
  ]
}

Crear columna de workflow

POST /projects-workflows

Agrega una nueva columna al tablero del proyecto.

Cuerpo de la solicitud

Campo	Tipo	Requerido	Descripción
`title`	string	Sí	Nombre de la columna
`company_slug`	string	Sí	Identificador del workspace
`project_slug`	string	Sí	Identificador del proyecto
`color`	string	No	Color hexadecimal sin `#`
`state`	integer	No	`0` = abierto, `1` = completado

curl -X POST https://services.gitscrum.com/projects-workflows \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "QA Review",
    "company_slug": "acme-corp",
    "project_slug": "web-platform",
    "color": "F59E0B",
    "state": 0
  }'

Actualizar columna de workflow

PUT /projects-workflows/{id}

Actualiza una columna de workflow.

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
`id`	integer	Sí	ID de la columna de workflow

Cuerpo de la solicitud

Campo	Tipo	Requerido	Descripción
`company_slug`	string	Sí	Identificador del workspace
`project_slug`	string	Sí	Identificador del proyecto
`title`	string	No	Nombre de la columna
`color`	string	No	Color hexadecimal sin `#`

Actualizar límite WIP

PUT /projects-workflows/{id}/wip

Establece el límite de trabajo en progreso para una columna.

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
`id`	integer	Sí	ID de la columna de workflow

Cuerpo de la solicitud

Campo	Tipo	Requerido	Descripción
`wip`	integer	Sí	Máximo de tareas permitidas (0 = ilimitado)
`company_slug`	string	Sí	Identificador del workspace
`project_slug`	string	Sí	Identificador del proyecto

Eliminar columna de workflow

DELETE /projects-workflows/{id}?companyslug={slug}&projectslug={slug}

Elimina una columna del tablero del proyecto. Las tareas en la columna se mueven a la columna predeterminada.

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
`id`	integer	Sí	ID de la columna de workflow

Referencia de campos

Campo	Tipo	Descripción
`id`	integer	ID de la columna del workflow — usado para mover tareas
`slug`	string	Identificador de columna amigable para URL
`title`	string	Nombre para mostrar de la columna
`color`	string	Color de la columna (hex)
`state`	integer	`0` = abierto, `1` = completado
`position`	integer	Posición de la columna en el tablero (1 = más a la izquierda)
`default`	boolean	Si es la columna predeterminada para nuevas tareas

Mover tareas entre columnas

Usa el id del workflow al actualizar la columna de una tarea:

curl -X PUT https://services.gitscrum.com/tasks/{task_uuid} \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "company_slug": "acme-corp",
    "project_slug": "web-platform",
    "workflow_id": 2
  }'

Esto mueve la tarea a la columna "In Progress" (ID 2).

Los IDs de workflow son específicos del proyecto. Siempre obtén la lista de workflows del proyecto destino antes de mover tareas.