Jira API (REST + Agile)

Automate Jira Cloud by managing worklogs, executing advanced JQL searches, editing/deleting worklogs, handling sprints, and making direct REST API calls.

Jira API

Usa jira-cli cuando exista el comando (listar issues, ver issue, transiciones, etc.). Usa este skill cuando jira-cli no cubra la operación o necesites una llamada REST directa.

Quick start (scripts)

Script principal (sin dependencias externas):

• skills/work/jira-api/scripts/jira_api.py

Ejemplos:

1. Buscar issues por JQL (API nueva):

./skills/work/jira-api/scripts/jira_api.py search-jql "worklogAuthor = currentUser() AND worklogDate >= 2026-03-09 AND worklogDate <= 2026-03-15" --fields key,summary,status --max 100

2. Listar worklogs de una issue (y filtrar por rango de fechas):

./skills/work/jira-api/scripts/jira_api.py list-worklogs DES-355 --from 2026-03-09 --to 2026-03-15

3. Borrar un worklog concreto (revertir imputación):

./skills/work/jira-api/scripts/jira_api.py delete-worklog DES-355 29978 --adjustEstimate auto

4. Actualizar un worklog (tiempo / comentario / started):

./skills/work/jira-api/scripts/jira_api.py update-worklog DES-355 29978 --timeSpent "3h 30m" --comment "Ajuste" --started "2026-03-10 12:00:00" --timezone Europe/Madrid --adjustEstimate auto

5. Llamada REST genérica (para cubrir lo que falte):

./skills/work/jira-api/scripts/jira_api.py request GET /rest/api/3/myself

Operativa y seguridad

• Autenticación esperada: API token en ~/.netrc (no pegar tokens en chat).
• No imprimir respuestas que puedan contener secretos; si necesitas compartir, recorta y elimina cabeceras.
• Antes de acciones destructivas (DELETE/ediciones masivas): confirmar con César.

Qué NO cubre jira-cli (motivación típica)

• Borrar/editar worklogs (en nuestro entorno, jira issue worklog solo tiene add).
• Operaciones REST puntuales que Jira Cloud expone pero el CLI no.
• Automatizaciones de “revertir”, “mover imputación”, “arreglar estimaciones”.

Sprints / Agile (rápido)

El tablero DES suele ser el 184.

# Ver sprints activos
./skills/work/jira-api/scripts/jira_api.py sprint-list --board 184 --state active

# Ver issues de un sprint
./skills/work/jira-api/scripts/jira_api.py sprint-issues <SPRINT_ID> --fields key,summary,status --max 200

Referencias

• Notas REST mínimas: references/jira-rest-notes.md (endpoints + ADF).
• Mapa de endpoints (equivalencias con jira-cli): references/endpoint-map.md.
• Agile/Sprints: references/agile-sprints.md.