SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillsjira

jira

Office & productivity

View repository

Updated 10-16 08:33

About this skill

Jira Integration

Connection

  • Base URL: $JIRA_BASE_URL (e.g. https://yourorg.atlassian.net)
  • Auth: Basic auth — Base64($JIRA_USER_EMAIL:$JIRA_API_TOKEN)
  • Env vars: JIRA_BASE_URL, JIRA_USER_EMAIL, JIRA_API_TOKEN
  • Caching: 10-minute in-memory cache, max 100 entries
  • API versions: REST API v3 (/rest/api/3), Agile API (/rest/agile/1.0)

Server Lib & API Routes

  • File: server/lib/jira.ts

Exported Functions

Function Description
searchIssues(jql, fields?, maxResults?) Search via JQL
getIssue(issueKey) Get single issue detail
getProjects() List all projects
getStatuses(projectKey?) List statuses (optionally by project)
getBoards() List agile boards
getSprints(boardId) List sprints for a board
getAnalytics(projects, days) Aggregate ticket analytics

API Routes

Route Description
GET /api/jira/search Search tickets via JQL
GET /api/jira/issue Get issue detail
GET /api/jira/projects List projects
GET /api/jira/statuses List statuses
GET /api/jira/boards List boards
GET /api/jira/sprints List sprints
GET /api/jira/analytics Ticket analytics

Dashboard

  • /adhoc/jira — Jira Tickets dashboard with Overview, Search, and Sprints tabs

Script Usage

# Search tickets
pnpm action jira-search --jql="summary ~ SSO ORDER BY created DESC" --fields=key,summary,status,assignee

# Ticket analytics
pnpm action jira-analytics --days=30
pnpm action jira-analytics --projects=ENG,PROD --days=30

Key Patterns & Gotchas

  • IMPORTANT: The old /rest/api/3/search endpoint was removed by Atlassian (returns 410). Must use /rest/api/3/search/jql instead.
  • JQL for duplicate detection: project = X AND summary ~ "keyword" ORDER BY created DESC
  • Always use markdown links for tickets: [ENG-1234](https://yourorg.atlassian.net/browse/ENG-1234)
  • getStatuses with a projectKey returns an array of issue type entries; the code flattens nested statuses
  • getAnalytics runs multiple search queries and aggregates client-side