# atlassian-api/atlassian-python-api

Atlassian Python REST API wrapper. The atlassian-python-api library provides a simple and convenient way to interact with Atlassian products (such as Jira Service management, Jira Software, Confluence, Bitbucket and apps Insight, X-Ray) using Python. It is based on the official REST APIs of these products and by community for Atlassian

Repository: https://github.com/atlassian-api/atlassian-python-api
Canonical: https://ross.abutalabs.com/products/atlassian-python-api
Homepage: http://atlassian-python-api.readthedocs.io/
Language: Python
License: Apache-2.0
License Family: permissive
Topics: atlassian, jira, confluence, bamboo, api, rest, python, bitbucket, jira-service-desk, portfolio, advanced-roadmaps, crowd, wrapper, tempo, xray, hacktoberfest
Last push: 2026-08-24T17:51:12+00:00

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 98, longevity 100
- inputs: {"age_days": 4501, "days_push": 9, "days_rel": 16, "gap_med": 5, "n_releases_24m": 16}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1670, forks 716 (observed 2026-08-28T04:05:19.972921+00:00)

## What it is
A Python library wrapping the official REST APIs of Atlassian products such as Jira, Confluence, Bitbucket, Bamboo, Crowd, and Service Desk. It supports Server, Data Center, and Cloud instances with multiple authentication methods including PAT, API tokens, and OAuth.

## Use cases
- automate creating and updating Confluence pages from Python
- query and update Jira issues programmatically
- manage Bitbucket repositories and pull requests via script
- integrate Atlassian Service Desk with internal tooling
- bulk-administer Atlassian Cloud and Server instances
- interact with X-Ray and Insight apps through their REST APIs

## When to choose
- you need Python access to Jira, Confluence, Bitbucket, or other Atlassian products without hand-writing REST calls
- you want one library covering both Atlassian Server/Data Center and Cloud
- you need automation or integration scripts around Atlassian tooling

## When to avoid
- you work with non-Atlassian issue trackers or wikis
- you need a CLI or GUI rather than a Python API
- you require async-first HTTP clients

## Facets
- artifact type: library
- maturity: active
- function: http-client, sdk, api-framework
- domain: apis, developer-tools, backend
- platform: python, cross-platform
- tags: atlassian, jira, confluence, bitbucket, rest-api-wrapper, service-desk, xray, crowd, bamboo, automation

## Member repositories
- atlassian-api/atlassian-python-api (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:19.972921+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:42:43.685689+00:00, confidence not recorded.
  - readme: https://github.com/atlassian-api/atlassian-python-api (fetched 2026-08-28T04:05:19.972921+00:00, sha 8563c68efcf1)
  - homepage: http://atlassian-python-api.readthedocs.io/ (fetched 2026-08-29T11:15:52.372926+00:00, sha 531051f4ae62)
  - registry_pypi: https://pypi.org/pypi/atlassian-python-api/json (fetched 2026-08-29T11:15:52.375789+00:00, sha bf1afdbd8289)
- Data as of 2026-08-30T08:39:29.467469+00:00.