Introduction
The Jira integration enables Sana Agents to read and write to Jira issues and projects.
Integration capabilities
The following Jira objects are supported:
Object | Read | Write |
Space (Project) | ✅ | ✅ |
Work (Issue) - Epic | ✅ | ✅ |
Work (Issue) - Story | ✅ | ✅ |
Work (Issue) - Task | ✅ | ✅ |
Work (Issue) - Sub-task | ✅ | ✅ |
Work (Issue) - Custom Work type | ✅ | ✅ |
Comments | ✅ | ✅ |
Common use-cases:
Search tickets, e.g. “Find Jira stories assigned to me”
Create tickets, e.g. “Create a bug in project Navbar with summary “404 error on link”
Update tickets, e.g. “Change the status of KAN-73 to in progress”
Get project updates, e.g. “What are the latest updates on the Landingpage project?”
Type of integration:
Private: Set up per user and mirroring the underlying individual access rights
Availability
Integration type | Free tier | Team tier | Enterprise tier |
Private | ❌ | ❌ | ✅ |
Shared | ❌ | ❌ | ❌ |
Centralized | ❌ | ❌ | ❌ |
Scope and permissions
Scope | Purpose | Type |
read:jira-work
| Read issues, projects, and other Jira content. | Required |
write:jira-work
| Create, edit, and transition Jira issues and work.
| Required |
read:jira-user
| Read Jira user profiles, groups, and basic account data. | Required |
manage:jira-project
| Administer projects, roles, components, and versions. | Required |
manage:jira-configuration
| Change global Jira settings, workflows, and permissions. | Required |
offline_access | Allow long-lived access tokens without user present. | Required |
Known limitations
Sana Agents’ Jira integration is optimized for look-ups of individual and/or small sets of records e.g. “find recent tickets assigned to me in Jira”, not aggregations and exhaustive search to e.g. “find all tickets ever created in Jira”.
Moving existing tickets is not supported yet. E.g moving a ticket from one project to another or moving a ticket to another sprint.
Integration set-up
1. Find Jira on the integration page and click “Connect just for me”.
2. Fill in your Jira Site URL.
3. Click Open Window to get redirected to Jira for authentication
4. Click accept to approve the required scopes
4. After the previous step, you get redirected back to Sana. Click the button “Finish setup”
5. Select the tools you want to be able to use to have granular control of what you want to be able to do with the Jira integration and then click “Continue”.
6. Optional: Add a custom system prompt if you want it to behave and answer your questions in a specific way.
6. You are now ready to use Jira in Sana.
FAQ
Q: Can I push content into Jira from Sana?
A: Yes.
Q: How often is Jira synced?
A: This integration is an API based integration which means that it makes API calls to fetch your data in real-time as you make a request. This means that your data does not need to be synced at all and it will always be up-to-date.
Data handling & privacy
Sana AI is fully committed to data security and privacy. All data accessed by Sana AI is encrypted both in transit and at rest. Sana does not train any underlying language models on your data, ensuring the privacy of your information. Sana AI is ISO 27001 certified; and SOC 2 and GDPR compliant, and adheres to the highest standards of data security.