Jira Cloud REST API Documentation

Complete reference documentation for Jira Cloud REST API v2 and v3 endpoints, including all models, parameters, and response formats.

Usage Priority: When working with Jira APIs, follow this order:

1. Quick Reference + Scripts - Check

   quick-reference/

   for your task, then read and run the scripts
   • To find quick-references:

     Glob(pattern: "*.md", path: ".claude/skills/jira-api-docs/quick-reference")

   • To find scripts:

     Glob(pattern: "*<keyword>*", path: ".claude/skills/jira-api-docs/scripts")

2. MCP Server Search - If no script exists, query

   jira-docs

   MCP server for endpoint details
3. Full API Reference - Consult

   api-reference/

   only if MCP doesn't cover your need
4. REQUIRED: Save your work - Save new scripts to

   scripts/

   and add them to quick-reference

Documentation Paths

All paths are under

~/.claude/skills/jira-api-docs/

:

~/.claude/skills/jira-api-docs/
├── quick-reference/           # Task → script mappings (check FIRST)
│   ├── workflows.md
│   └── ...
├── scripts/                   # Working scripts (READ AND USE THESE)
│   ├── fetch-workflow-table.sh
│   └── ...
└── api-reference-guide.md     # Navigation guide for Task agents (last resort)

When to Use This Skill

✅ Use when:

• Making Jira API calls or HTTP requests
• Looking up specific Jira API endpoints
• Understanding Jira API request/response formats
• Troubleshooting Jira API integrations
• Finding API endpoint parameters and options
• Working with Jira webhooks or automation
• Building Jira integrations or scripts

❌ Don't use when:

• General Jira usage questions (use Jira UI instead)
• Jira administration via web interface
• JQL query help (unless related to API endpoints)
• Jira workflow configuration via UI

Common API Tasks

Workflows

Quick Reference:

./quick-reference/workflows.md

— read this first, use the scripts

Everything Else

1. Query the

   jira-docs

   MCP server
2. If MCP fails after 2-3 attempts, launch a Task agent — the raw API docs are thousands of lines and tens of thousands of tokens; tell the agent your requirements and to read

   ./api-reference-guide.md

Test Sandbox

Safe resources for testing — do NOT use production projects/objects:

• Projects:

  TESTPROJ

  (Service Desk),

  HSP

  (Software)
• Issues: Create new in HSP/TESTPROJ (don't rely on existing)
• Filter: "Test Filter" (ID: 12229)
• Dashboard: "Test Dashboard" (ID: 10275)
• Group: "Test Group" (ID: 60870276-7f12-4367-af84-23903ab1553c)
• Custom fields: Use existing

  TestField_*

  or create with that prefix
• Sprints/Boards: Use or create in HSP/TESTPROJ

Before Finishing

⚠️ STOP: Before marking a Jira task complete:

• New script? → Save to

  scripts/

  + add to quick-reference
• Fixed a script? → Update script + add lesson learned