Prerequisites
- Your admin must complete the initial Jira setup and enable Jira actions in the Admin Console so that the Jira action pack is available in Agent Builder.
- Each user is prompted to connect their Jira account via OAuth in Glean before running agents that use Jira actions, including Jira Assign issue.
- If your Jira organization uses Central OAuth, a Jira administrator must authorize the app for the site before users can run Jira actions in Glean.
Supported parameters
| Parameter | Type | Description |
|---|---|---|
| Search query | String | Text to search for in project names and descriptions. |
| Name | String | Filter projects by exact or partial name match. |
| Category ID | String | Filter projects by category identifier. |
| Status | String | Filter projects by status (e.g., live, archived). |
| Action | String | Type of action to perform when retrieving projects. |
| Expand | String | Comma-separated list of additional fields to expand in the response. |
| Properties | String | Additional properties to include in the results. |
| Sort by | String | Field to sort results by (e.g., name, key, category). |
| Start at | Integer | Zero-based index for pagination to fetch subsequent pages. |
| Results limit | Integer | Maximum number of projects to return per page. |
Usage examples
- “Show me all active Jira projects in our Engineering category.”
- “List all Jira projects I have access to.”
- “What archived projects exist in Jira?”
Troubleshooting
No projects returned or fewer projects than expected
No projects returned or fewer projects than expected
- Possible cause: The connected account does not have permission to view all projects, or filters are too restrictive.
- Fix: Confirm that the connected account has permission to view the projects directly in Jira. Try removing filters like Status or Category ID to see if more projects are returned.
Permission or authentication errors
Permission or authentication errors
- Possible cause: The Jira action pack is not fully configured, or the connected account is missing, inactive, or lacks the required scopes to read projects.
- Fix: Ask an admin to verify that the Jira action pack is enabled for your deployment and that the user has an active connected account with the right scopes. Have the user reconnect their Jira account if the token has expired.
Action not available in agent builder
Action not available in agent builder
- Possible cause: The Jira action pack is not enabled, or there is a configuration issue preventing the action from appearing.
- Fix: Ask your Glean admin to verify that the Jira action pack is enabled and properly configured for your deployment. If the issue persists, contact Glean support.
Pagination not working as expected
Pagination not working as expected
- Possible cause: The Start at index is beyond the available results, or Results limit is set too low.
- Fix: Check that Start at is a valid index within the result set. Start with Start at set to 0 and use the total count from the response to calculate pagination offsets.
FAQs
Can I retrieve archived projects?
Can I retrieve archived projects?
Yes. Set the Status parameter to “archived” to retrieve only archived projects, or leave it empty to retrieve all projects regardless of status.
How does pagination work?
How does pagination work?
Use Results limit to control how many projects are returned per page, and Start at to specify the starting index for pagination. For example, to get the second page of 50 projects, set Start at to 50 and Results limit to 50.