api-reference

name	api-reference
description	This skill should be used when the user asks for "Jira API endpoints", "Confluence API endpoints", "Jira/Confluence REST API", "Atlassian curl examples", "the exact method/parameters" for any Jira or Confluence resource, or needs HTTP details for issues, JQL search, comments, worklogs, attachments, links, projects, versions, components, fields, screens, workflows, statuses, users, groups, permissions, schemes, dashboards, filters, plans; or Confluence pages, blog posts, spaces, comments, attachments, labels, content properties. Indexes the full per-domain endpoint catalog plus the bundled OpenAPI specs.
disable-model-invocation	true

Atlassian REST API Reference (Jira v3 + Confluence v2)

Complete catalog for the Jira Cloud platform REST API v3 and the Confluence Cloud REST API v2, split by domain. Official docs: https://developer.atlassian.com/cloud/jira/platform/rest/v3/ and https://developer.atlassian.com/cloud/confluence/rest/v2/

The exhaustive source of truth is the two bundled OpenAPI specs:

• references/jira-openapi-v3.json — 420 paths, 99 tags (OpenAPI 3.0.1).
• references/confluence-openapi-v2.json — 147 paths, 29 tags (OpenAPI 3.0.3).

The curated references/jira/*.md and references/confluence/*.md files below cover the common operations in plain, copy-pasteable form.

Load the setup skill first for authentication and the global conventions (Basic auth, headers, ADF/storage bodies, Jira startAt/maxResults vs Confluence cursor pagination, ) — those rules apply to every method here and are not repeated in each file.

User: "What's the endpoint to create a Jira issue?" → Open `references/jira/issues.md`. `POST /issue` with `{"fields":{"project":{"key":"PROJ"},"issuetype":{"name":"Task"},"summary":"…","description":}}`. `description` must be ADF JSON, not a string. User: "How do I search issues with JQL?" → Open `references/jira/search-jql.md`. `POST /search/jql` with `{"jql":"project = PROJ ORDER BY created DESC","fields":["summary","status"],"maxResults":50}`. Page with the returned `nextPageToken`. User: "Give me the curl to update a Confluence page." → Open `references/confluence/pages-blogposts.md`. `GET /pages/{id}?body-format=storage` to read the current `version.number`, then `PUT /pages/{id}` with `{"id","status":"current","title","version":{"number":},"body":{"representation":"storage","value":""}}`.