skills.rest
bm629
bm629COMMUNITY
Explore all skills by this author →
GitHub

atlassian-rest-ops

Executes Confluence Cloud v2 and Jira Cloud v3 REST API operations via curl with OpenAPI-resolved request shapes.

1|1|Updated May 24, 2026
Search Tags:#openapi#rest api#jira#atlassian#confluence#curl#adf
One-click install
npx skills add https://github.com/bm629/agent-skills --skill atlassian-rest-ops-bm629
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: atlassian-rest-ops
Source: https://github.com/bm629/agent-skills/tree/main/skills/atlassian-rest-ops
Command: npx skills add https://github.com/bm629/agent-skills --skill atlassian-rest-ops-bm629

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Calling the Atlassian Cloud REST API correctly requires knowing hundreds of endpoints, per-API differences in base URLs, pagination, error formats, and the tricky ADF versus storage rich-text body formats. This Skill lets an agent perform any Confluence or Jira Cloud operation directly with curl, resolving exact request schemas from bundled OpenAPI specs instead of guessing. ## Core Features & Use Cases - Full API coverage: Constructs any of 800+ endpoints across Confluence Cloud v2 (pages, spaces, search) and Jira Cloud v3 (issues, JQL search, comments) using a bundled OpenAPI spec, an endpoint index, and a $ref-resolver script. - Per-API patterns: Handles the differences between Confluence and Jira for base URLs, pagination (cursor vs startAt/nextPageToken), error envelopes, and rate limits. - Rich-text handling: Builds Jira ADF bodies as raw JSON objects and Confluence bodies as stringified ADF or storage XHTML, with a Markdown-to-ADF converter for formatted content. - Use Case: Ask the agent to create a Confluence page in a given space; it resolves the createPage schema, builds the curl call with your injected credentials, and returns the created page's id and URL. ## Quick Start Use atlassian-rest-ops to create a Confluence page titled "Release Notes" in my TEAM space.

Frequently Asked Questions about atlassian-rest-ops

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Confluence page via the REST API?▼

POST to <base_url>/wiki/api/v2/pages with a JSON body containing spaceId, status, title, and a body object with representation and value. The skill resolves the exact createPage schema from the bundled OpenAPI spec and includes a validated example script.

How do I search Jira issues with JQL using the REST API?▼

Use GET /rest/api/3/search/jql with a JQL query and nextPageToken pagination, which replaces the deprecated /search endpoint. Note that unbounded JQL (ordering-only or empty queries) is rejected with a 400 error, so always include a restriction like project = X.

What is the difference between Jira ADF and Confluence body formats?▼

Jira accepts ADF as a raw JSON object, while Confluence expects {representation, value} where atlas_doc_format means the ADF JSON stringified and storage means an XHTML string. Mixing these up is the most common failure when posting rich text.

Does this work with Atlassian Server or Data Center?▼

No, this skill targets Atlassian Cloud only, authenticating with a Cloud email plus API token via HTTP Basic auth. Server and Data Center instances use different authentication and API paths and are explicitly out of scope.

Why is my Confluence page still visible after DELETE?▼

Confluence delete is two-stage: DELETE /pages/{id} only trashes the page, which still returns with status trashed. To remove it permanently, call DELETE /pages/{id}?purge=true after it has been trashed.

Do I need to install an SDK or Python packages to call the Atlassian API?▼

No SDK or pip install is needed. All API calls use curl, and the only helper is a Python stdlib-only script that resolves endpoint schemas from the bundled OpenAPI specs.

Related Skills

Explore More Software Engineering Skills→
al-steval-stev

atlassian-setup

Configure Atlassian API credentials for Jira and Confluence access.

Community
Intermediate
walconwalcon

atlassian

Perform CRUD operations on Jira issues and Confluence pages via REST APIs.

Community
Advanced
arozumenkoarozumenko
18

atlassian-content

Create and repair Jira and Confluence content with deployment-specific formats.

Community
Advanced
fanguyunfanguyun

atlassian-mcp

Manage Jira issues and Confluence pages via the MCP protocol.

Community
Advanced