Integrations

Jira Integration

Used for: Context

Promptless integrates with both Jira Cloud and Jira Data Center instances.

Integration Types

Promptless supports two types of Jira integrations depending on your Jira deployment:

Jira Cloud

For Atlassian-hosted Jira instances. Uses OAuth 2.0 authentication through Atlassian’s secure connection process.

Jira Data Center (Beta)

For self-hosted Jira Data Center installations. Uses username and password authentication with your organization’s instance.

Jira Data Center is in Beta. Please contact the Promptless team at help@gopromptless.ai to connect your Jira Data Center instance to Promptless.

Jira Cloud Installation

For Atlassian Cloud-hosted Jira instances:

1

Connect Jira Cloud

Click “Connect Jira Cloud” from the integrations page.

2

Atlassian Login

If you’re not already logged in, you’ll see the Atlassian login screen:

Atlassian Login Screen
4

Complete Connection

Click “Accept” and verify the connection in Promptless. If you don’t see the option to accept, you may not have the required permissions. Contact your Jira administrator or invite them to Promptless. For more information about adding new members, see our Account Management page.

After connecting, manage Promptless access by going to your avatar > Account settings > Connected apps in Atlassian:

Atlassian Connected Apps Management

Project Setup and Permissions

After connecting Jira, you can configure which projects you’d like Promptless to search in when setting up a Project in the projects page. Promptless will not search projects not specified here.

Project configuration screen showing context sources setup with Jira integration
Jira context configuration interface showing connected status and accessible projects

JQL Search Capabilities

Promptless leverages Jira’s powerful JQL (Jira Query Language) search functionality to find relevant context:

  • Automatic Issue Retrieval: When a GitHub PR or other trigger mentions a Jira ticket (like “PROJ-123”), Promptless automatically retrieves that specific issue for additional context.

  • Proactive JQL Searches: Promptless can proactively search Jira using JQL queries to find related issues, epics, and project data that might be relevant to the documentation being generated.

Promptless queries Jira data in real-time and does not store any of your Jira data. All searches are performed on-demand when documentation updates are needed.

Troubleshooting

If you’re having trouble connecting to Jira:

  • Ensure you have the necessary permissions in your Jira instance
  • Check that your Jira instance allows OAuth 2.0 applications
  • Contact your Jira administrator if you encounter permission errors

If Promptless isn’t finding relevant Jira issues:

  • Verify that the projects are configured correctly in your Promptless project settings
  • Check that the issues exist in the configured projects
  • Ensure the issues are accessible with your current Jira permissions

If you need to re-authenticate with Jira:

For additional support, contact help@gopromptless.ai.