Atlassian API Skill
Provides comprehensive Atlassian API integration capabilities for the Golden Armada AI Agent Fleet Platform.
When to Use This Skill
Activate this skill when working with:
Jira REST API integration Confluence REST API integration Atlassian webhooks Automation and scripting Cross-platform synchronization Authentication API Token (Cloud)
```python import requests from requests.auth import HTTPBasicAuth
auth = HTTPBasicAuth('email@example.com', 'API_TOKEN') headers = { 'Accept': 'application/json', 'Content-Type': 'application/json' }
base_url = 'https://your-domain.atlassian.net' ```
Python Client Library
```python from atlassian import Jira, Confluence
jira = Jira( url='https://your-domain.atlassian.net', username='email@example.com', password='API_TOKEN', cloud=True )
confluence = Confluence( url='https://your-domain.atlassian.net', username='email@example.com', password='API_TOKEN', cloud=True ) ```
Jira REST API Issues
Create issue
response = requests.post( f'{base_url}/rest/api/3/issue', auth=auth, headers=headers, json={ 'fields': { 'project': {'key': 'GA'}, 'summary': 'Implement agent monitoring', 'description': { 'type': 'doc', 'version': 1, 'content': [ { 'type': 'paragraph', 'content': [ {'type': 'text', 'text': 'Description text'} ] } ] }, 'issuetype': {'name': 'Story'}, 'priority': {'name': 'High'}, 'labels': ['backend', 'monitoring'] } } )
Get issue
response = requests.get( f'{base_url}/rest/api/3/issue/GA-123', auth=auth, headers=headers ) issue = response.json()
Update issue
response = requests.put( f'{base_url}/rest/api/3/issue/GA-123', auth=auth, headers=headers, json={ 'fields': { 'summary': 'Updated summary' } } )
Transition issue
First, get available transitions
transitions = requests.get( f'{base_url}/rest/api/3/issue/GA-123/transitions', auth=auth, headers=headers ).json()
Then transition
requests.post( f'{base_url}/rest/api/3/issue/GA-123/transitions', auth=auth, headers=headers, json={'transition': {'id': '31'}} # ID from available transitions )
Add comment
requests.post( f'{base_url}/rest/api/3/issue/GA-123/comment', auth=auth, headers=headers, json={ 'body': { 'type': 'doc', 'version': 1, 'content': [ { 'type': 'paragraph', 'content': [ {'type': 'text', 'text': 'Comment text'} ] } ] } } ) ```
JQL Search
```python
Search issues
jql = 'project = GA AND status = "In Progress" ORDER BY created DESC' response = requests.get( f'{base_url}/rest/api/3/search', auth=auth, headers=headers, params={ 'jql': jql, 'maxResults': 50, 'fields': 'summary,status,assignee,priority' } ) results = response.json()
for issue in results['issues']: print(f"{issue['key']}: {issue['fields']['summary']}") ```
Sprints and Boards
```python
Get boards
boards = requests.get( f'{base_url}/rest/agile/1.0/board', auth=auth, headers=headers ).json()
Get sprints for a board
board_id = 1 sprints = requests.get( f'{base_url}/rest/agile/1.0/board/{board_id}/sprint', auth=auth, headers=headers ).json()
Get issues in sprint
sprint_id = 10 issues = requests.get( f'{base_url}/rest/agile/1.0/sprint/{sprint_id}/issue', auth=auth, headers=headers ).json()
Move issues to sprint
requests.post( f'{base_url}/rest/agile/1.0/sprint/{sprint_id}/issue', auth=auth, headers=headers, json={'issues': ['GA-123', 'GA-124']} ) ```
Confluence REST API
Pages
```python
Create page
response = requests.post( f'{base_url}/wiki/rest/api/content', auth=auth, headers=headers, json={ 'type': 'page', 'title': 'Agent Architecture', 'space': {'key': 'GA'}, 'body': { 'storage': { 'value': 'OverviewContent here...', 'representation': 'storage' } } } )
Get page
page = requests.get( f'{base_url}/wiki/rest/api/content/12345', auth=auth, headers=headers, params={'expand': 'body.storage,version'} ).json()
Update page
requests.put( f'{base_url}/wiki/rest/api/content/12345', auth=auth, headers=headers, json={ 'type': 'page', 'title': 'Updated Title', 'body': { 'storage': { 'value': 'Updated Content', 'representation': 'storage' } }, 'version': {'number': page['version']['number'] + 1} } )
Search pages
results = requests.get( f'{base_url}/wiki/rest/api/content/search', auth=auth, headers=headers, params={'cql': 'space = GA AND text ~ "agent"'} ).json() ```
Webhooks
Jira Webhook Handler
```python from flask import Flask, request
app = Flask(name)
@app.route('/webhooks/jira', methods=['POST']) def handle_jira_webhook(): event = request.json event_type = event.get('webhookEvent')
if event_type == 'jira:issue_created':
issue = event['issue']
handle_issue_created(issue)
elif event_type == 'jira:issue_updated':
issue = event['issue']
changelog = event.get('changelog', {})
handle_issue_updated(issue, changelog)
elif event_type == 'sprint_started':
sprint = event['sprint']
handle_sprint_started(sprint)
return {'status': 'ok'}
def handle_issue_created(issue): print(f"Issue created: {issue['key']}")
def handle_issue_updated(issue, changelog): for item in changelog.get('items', []): if item['field'] == 'status': print(f"Issue {issue['key']} status changed: {item['fromString']} -> {item['toString']}") ```
Register Webhook
```python
Register Jira webhook
webhook = requests.post( f'{base_url}/rest/webhooks/1.0/webhook', auth=auth, headers=headers, json={ 'name': 'Golden Armada Integration', 'url': 'https://your-app.com/webhooks/jira', 'events': [ 'jira:issue_created', 'jira:issue_updated', 'sprint_started', 'sprint_closed' ], 'filters': { 'issue-related-events-section': 'project = GA' } } ) ```
Automation Recipes
Sync GitHub PR to Jira
```python async def sync_pr_to_jira(pr_data: dict): # Extract Jira issue key from branch name (e.g., feature/GA-123-add-feature) branch = pr_data['head']['ref'] match = re.search(r'(GA-\d+)', branch) if not match: return
issue_key = match.group(1)
# Add comment with PR link
jira.add_comment(
issue_key,
f"PR opened: [{pr_data['title']}]({pr_data['html_url']})"
)
# Transition to "In Review" if PR is ready
if not pr_data.get('draft'):
jira.transition_issue(issue_key, 'In Review')
Auto-create Release Notes
```python def generate_release_notes(version: str, project_key: str = 'GA'): # Get all issues in the release jql = f'project = {project_key} AND fixVersion = "{version}" ORDER BY issuetype' issues = jira.jql(jql)['issues']
Group by type
features = [i for i in issues if i['fields']['issuetype']['name'] == 'Story'] bugs = [i for i in issues if i['fields']['issuetype']['name'] == 'Bug']
Generate markdown
notes = f"# Release {version}\n\n" notes += "## Features\n" for issue in features: notes += f"- [{issue['key']}] {issue['fields']['summary']}\n" notes += "\n## Bug Fixes\n" for issue in bugs: notes += f"- [{issue['key']}] {issue['fields']['summary']}\n"
Create Confluence page
confluence.create_page( space='GA', title=f'Release Notes - {version}', body=markdown_to_confluence(notes), parent_id=RELEASE_NOTES_PARENT_ID )
```
Golden Armada Commands
```bash
Sync with Atlassian
/atlassian-sync --jira --confluence
Create Jira issue from template
/jira-create --type story --template agent-feature
Update Confluence docs from code
/confluence-publish --from docs/ --space GA ```