Skill

jira

Jira Cloud platform REST API documentation

Verified: 2026-05-13 (printing-press-ingest-2026-05-13+enrich-capability-skill)

When to use jira

Choose if

You're running Jira Cloud workflows from an agent loop and want a single typed CLI surface for issue creation, bulk edit/transition, attachments, comments, custom fields, dashboards, user/group admin, and audit records. Alternative class is the official Atlassian SDK or Jira's MCP server — pick this one when you want token-saving --compact output, typed exit codes for self-correction, and one install command that covers every REST endpoint.

Avoid if

You're on Jira Data Center / Server (not Cloud) — the CLI targets Cloud's REST API only. Also avoid for archive workflows on Free/Standard plans (requires Premium or Enterprise), and avoid if your single request needs to touch more than 1000 issues without chunking.

Risk Flags

  • LOW scope Bulk operations are capped: bulk-edit 1000 issues + 200 fields per request; bulk-create 50 issues; bulk-fetch 100 issues; archive-async allows only one active request per Jira instance at a time. Heavy workloads must chunk.
  • MEDIUM auth Some destructive operations (archive, application property changes) require Premium/Enterprise license and admin-level scopes; the README warns: "Be careful when changing application properties and advanced settings."
  • LOW scope Deprecated endpoints exist for field-configuration operations; the README recommends migrating to field-association schemes. Agents calling deprecated paths may see them sunset without notice.

Cost

Type: Freemium · Free tier: The CLI binary is free to install. Jira Cloud has its own free tier (up to 10 users at time of writing); the agent uses a JIRA_API_TOKEN tied to a user's account.

Hidden costs

  • The CLI is a free wrapper; the underlying Jira Cloud account is what costs money. Some endpoints (e.g., archive operations) require Premium or Enterprise licensing on the workspace side.

Install

Default

npx -y @mvanhorn/printing-press install jira
# Configure Jira Cloud credentials:
export JIRA_EMAIL=<your-email>
export JIRA_API_TOKEN=<api-token>
export JIRA_BASE_URL=https://<your-workspace>.atlassian.net

Setup docs →

Estimated time to first success: ~10 min

Dependencies

Minimum runtime: Node.js 18+ (via npx) — pre-built macOS/Unix binaries available as fallback

Distribution

Repository
https://github.com/mvanhorn/printing-press-library
License
MIT