Jira

Setup

1. Create Atlassian OAuth app

developer.atlassian.com → Console → Create → OAuth 2.0 integration.

Scopes:

• read:jira-work
• write:jira-work
• manage:jira-project (if creating projects)

Callback: https://tappass.example.com/providers/jira/callback

2. Configure on TapPass server

JIRA_CLIENT_ID=<id>
JIRA_CLIENT_SECRET=<secret>
JIRA_SITE=yourcompany.atlassian.net

3. Authorise

tappass provider connect jira --agent support-bot

Operations

Operation	Op group	Endpoint
list_issues	read	GET /rest/api/3/search
get_issue	read	GET /rest/api/3/issue/{key}
create_issue	write	POST /rest/api/3/issue
transition_issue	write	POST /rest/api/3/issue/{key}/transitions
add_comment	write	POST /rest/api/3/issue/{key}/comment

Usage

# Search
issues = agent.call_provider(
    provider="jira",
    operation="list_issues",
    params={
        "jql": 'project = SUP AND status = "To Do"',
        "fields": "summary,assignee,priority",
    },
)

# Create
agent.call_provider(
    provider="jira",
    operation="create_issue",
    params={
        "fields": {
            "project": {"key": "SUP"},
            "summary": "Customer reports API errors",
            "issuetype": {"name": "Bug"},
        }
    },
)

# Transition
agent.call_provider(
    provider="jira",
    operation="transition_issue",
    params={"key": "SUP-123", "transition": {"id": "31"}},
)

API token (alternative)

For single-user setups, skip OAuth and use a Jira API token:

# config/providers/jira.yaml (override)
auth:
  type: basic
  username_env: JIRA_EMAIL
  password_env: JIRA_API_TOKEN

Atlassian data residency

Jira Cloud supports EU region pinning — set it under Organization → Data residency in Atlassian admin. TapPass honours the resulting endpoint automatically.