Known differences

Jira and Confluence

One Atlassian Cloud site that answers Jira, Jira Software, Jira Service Management and Confluence REST, plus Atlassian's MCP tools.

Vendor reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/ ↗. Machine-readable: compat/jira-confluence.json.

Surfaces

KindPathNotes
REST/rest/api/3Jira platform REST, also /rest/api/2 and /rest/api/latest
REST/rest/agile/1.0Jira Software boards, sprints and backlogs
REST/rest/servicedeskapiJira Service Management
REST/wiki/rest/apiConfluence v1, and Confluence v2 under /wiki/api/v2
MCP/mcpAtlassian MCP tools for Jira and Confluence

API versions: Jira REST v3, v2, latest, Jira Software agile 1.0, Confluence REST v1 and v2

Supported

Not supported

Known differences and test guidance

ScenarioDifference from Jira and ConfluenceIn your tests
Text search (~, CQL text)Whole-word matching with simple plural and -ing folding, phrases and wildcards; no relevance ranking, synonyms or language analysis. /search/approximate-count returns the exact count.Assert that an issue or page is found, not on its order or on fuzzy matches.
AuthenticationOpen mode accepts any credential; strict mode only checks the token came from the bundled IdP. Authorization is still evaluated.Test what a credential may do, not whether a bad credential is rejected by Atlassian identity.
User identifiersUsers carry the Cloud accountId and also the Server/Data Center name and key, accepted wherever a user is named.Do not assert that name or key are absent; use accountId for Cloud behaviour.
DatesGenerated activity is shifted forward so relative-date queries match.Assert with relative JQL (created >= -7d), not on absolute dates.
Rate limitsNothing throttles until a fault is injected.Inject throttle or fail_next to test backoff.
Page sizemaxResults clamps to 100 on Jira and limit to 200 on Confluence v1, as Atlassian does, rather than answering 400.Follow pagination; do not assume a large page size is honoured.

Fault injection

KeyWhat the client sees
throttle429 with Retry-After, X-RateLimit-* headers and RateLimit-Reason jira-burst-based, in the Jira or Confluence envelope
fail_nextThe next N calls fail as throttle does, then clear
quota_limit429 with RateLimit-Reason jira-quota-global-based
error_rate500 in the product's error envelope for the given fraction of calls
latency_msFixed added latency on every data-plane request

Applies to every system