> ## Documentation Index
> Fetch the complete documentation index at: https://squad.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Jira
> What agents can do in Jira at each access level, and how to connect, limit, and disconnect Jira.
Connect Jira so your agents can work in your Jira account. You choose an access level for each account, and Squad refuses any agent action outside that level.
## Access levels
Each Jira account has an access level: **Read-only**, **Read + write**, and **Full access**. Squad refuses any agent action outside that level. You can also narrow or block single agents under **Per-agent access**.
| Level | The connect window describes this level as | Actions agents can use |
| ------------------------------ | ------------------------------------------------- | ---------------------- |
| **Read-only** | "Read issues, projects, and users." | 70 of 102 |
| **Read + write** (recommended) | "Read and write issues, comments, transitions." | 91 of 102 |
| **Full access** | "Manage projects, fields, workflows, and config." | 102 of 102 |
**Read + write** is the recommended level. The connect window selects it for you, and you can choose another level.
The Jira sign-in page asks you to approve full access to your account. This is expected. Squad does not narrow the sign-in. It checks every agent action against the level you chose, and it refuses actions outside that level.
## What agents can do at each level
Each level opens with a short summary in plain tasks, then lists every action it adds, grouped by what the action works on. You do not need to name actions. Ask in plain words, and the agent searches for the matching action.
**Find an action.** Open a level and use your browser's find (Ctrl+F, or Cmd+F on a Mac) with a word from the task or part of a slug. Or ask your agent in plain words, for example "What can you do in my Jira account?" The agent can search the Jira actions for you.
Each action shows its name, a one-line description where the Jira action catalog has one, and its slug. The slug is the ID that agents use when they call the action.
Agents can use 70 of the 102 Jira actions at this level:
* View projects
* View types
* View and search users
* View fields
* View roles and permissions
* View comments
* View filters
* View groups
* View and search issues
* View and search dashboards
* View profiles
* View sprints
All 70 actions at this level:
| Action | What it does | Slug |
| ------------------- | ----------------------------------------------------------------------------- | -------------------------- |
| Get attachment | Retrieves the binary content of a Jira attachment by ID. | `JIRA_GET_ATTACHMENT` |
| Get attachment meta | Retrieve Jira attachment settings including upload limits and enabled status. | `JIRA_GET_ATTACHMENT_META` |
| Action | What it does | Slug |
| ----------- | ------------------------------------------------------------------- | ------------------ |
| List boards | Retrieves paginated Jira boards with filtering and sorting options. | `JIRA_LIST_BOARDS` |
| Action | What it does | Slug |
| ------------------- | ------------------------------------------------------------------------------ | -------------------------- |
| Get comment | Retrieves a specific comment by ID from a Jira issue with optional expansions. | `JIRA_GET_COMMENT` |
| List comments | Retrieve multiple comments by their IDs in a single request. | `JIRA_LIST_COMMENTS` |
| List issue comments | Retrieves paginated comments from a Jira issue with optional ordering. | `JIRA_LIST_ISSUE_COMMENTS` |
| Action | What it does | Slug |
| -------------- | ----------------------------------------------------------------- | --------------------- |
| Get components | Retrieve components from Jira projects with search and filtering. | `JIRA_GET_COMPONENTS` |
| Action | What it does | Slug |
| ----------------- | --------------------------------------------------------------------------- | ------------------------ |
| Get dashboards | List and search Jira dashboards visible to the current user. | `JIRA_GET_DASHBOARDS` |
| Search dashboards | Search for Jira dashboards with filtering, sorting, and pagination support. | `JIRA_SEARCH_DASHBOARDS` |
| Action | What it does | Slug |
| ------------------------------------- | ------------------------------------------------------------------------- | -------------------------------------------- |
| Get create metadata issue type fields | Retrieve field metadata for a specific issue type in a project. | `JIRA_GET_CREATE_METADATA_ISSUE_TYPE_FIELDS` |
| Get fields | Retrieve Jira issue fields metadata. | `JIRA_GET_FIELDS` |
| Get fields paginated | Retrieve Jira fields in pages. | `JIRA_GET_FIELDS_PAGINATED` |
| Get service desk request type fields | Retrieve JSM request type field metadata for filling out portal requests. | `JIRA_GET_SERVICE_DESK_REQUEST_TYPE_FIELDS` |
| Action | What it does | Slug |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------- | --------------------------- |
| Get favorite filters | Retrieve favorite filters for the current user. | `JIRA_GET_FAVORITE_FILTERS` |
| Get filter | Retrieves a specific Jira saved filter by ID, including its JQL and sharing metadata, to reuse in subsequent searches. | `JIRA_GET_FILTER` |
| List filters | Search and list Jira saved filters (saved searches) visible to the current user. | `JIRA_LIST_FILTERS` |
| Action | What it does | Slug |
| ------------------ | -------------------------------------------------------------------- | ------------------------- |
| Get all groups | Retrieves all groups from the Jira instance with pagination support. | `JIRA_GET_ALL_GROUPS` |
| Get group | Retrieves details of a specific Jira group by name or ID. | `JIRA_GET_GROUP` |
| Get user groups | | `JIRA_GET_USER_GROUPS` |
| List groups picker | Search and list groups using Jira's picker endpoint. | `JIRA_LIST_GROUPS_PICKER` |
| Action | What it does | Slug |
| ------------------------------- | ---------------------------------------------------------------------------- | -------------------------------------- |
| Fetch bulk issues | Bulk fetch multiple Jira issues by their IDs or keys (max 100 per call). | `JIRA_FETCH_BULK_ISSUES` |
| Get issue | Retrieves a Jira issue by ID or key with customizable fields and expansions. | `JIRA_GET_ISSUE` |
| Get issue create metadata | Retrieve issue creation metadata for Jira projects. | `JIRA_GET_ISSUE_CREATE_METADATA` |
| Get issue edit metadata | Retrieve editable fields for a Jira issue. | `JIRA_GET_ISSUE_EDIT_METADATA` |
| Get issue picker suggestions | Get issue picker suggestions from Jira. | `JIRA_GET_ISSUE_PICKER_SUGGESTIONS` |
| Get issue resolutions | Retrieves all available issue resolution types from Jira. | `JIRA_GET_ISSUE_RESOLUTIONS` |
| Search for issues using jql get | Searches for Jira issues using JQL with pagination and field selection. | `JIRA_SEARCH_FOR_ISSUES_USING_JQL_GET` |
| Search issues | Advanced Jira issue search supporting structured filters and raw JQL. | `JIRA_SEARCH_ISSUES` |
| Action | What it does | Slug |
| ------------------------ | ------------------------------------------------------------------------ | ------------------------------- |
| Get mypreferences locale | Retrieve the locale preference of the currently authenticated Jira user. | `JIRA_GET_MYPREFERENCES_LOCALE` |
| Action | What it does | Slug |
| ---------------------- | -------------------------------------------------------- | ----------------------------- |
| Get remote issue links | Retrieves links from a Jira issue to external resources. | `JIRA_GET_REMOTE_ISSUE_LINKS` |
| Action | What it does | Slug |
| ------------------------------- | -------------------------------------------------------------------------------- | -------------------------------------- |
| Get universal avatar type owner | Retrieve all avatars (system and custom) for a specific type and entity in Jira. | `JIRA_GET_UNIVERSAL_AVATAR_TYPE_OWNER` |
| Action | What it does | Slug |
| -------------------------------- | --------------------------------------------- | --------------------------------------- |
| Search for issues using jql post | DEPRECATED: Use JIRA\_SEARCH\_ISSUES instead. | `JIRA_SEARCH_FOR_ISSUES_USING_JQL_POST` |
| Action | What it does | Slug |
| -------------------- | ---------------------------------------------------------------------------------------- | --------------------------- |
| Get system avatars | Retrieve all system avatars for a specific type (issuetype, project, user, or priority). | `JIRA_GET_SYSTEM_AVATARS` |
| Get view type avatar | Retrieve a specific avatar image by type and ID from Jira. | `JIRA_GET_VIEW_TYPE_AVATAR` |
| Action | What it does | Slug |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| Get all projects | Retrieves all visible projects using the modern paginated Jira API with server-side filtering and pagination support. | `JIRA_GET_ALL_PROJECTS` |
| Get permitted projects | Retrieve projects where the current user has specific permissions. | `JIRA_GET_PERMITTED_PROJECTS` |
| Get project | Retrieves details of a Jira project by its ID or key. | `JIRA_GET_PROJECT` |
| Get recent projects | Retrieves a list of projects recently accessed by the authenticated user. | `JIRA_GET_RECENT_PROJECTS` |
| List all projects | List all projects accessible to the user. | `JIRA_LIST_ALL_PROJECTS` |
| Action | What it does | Slug |
| ------------------ | ----------------------------------------------------- | ------------------------- |
| Get issue property | Retrieves a custom property from a Jira issue by key. | `JIRA_GET_ISSUE_PROPERTY` |
| Action | What it does | Slug |
| ------------------ | ----------------------------------------------------------------------- | ------------------------- |
| Check permissions | Check user permissions for global and project-level operations in Jira. | `JIRA_CHECK_PERMISSIONS` |
| Get my permissions | Retrieve the user's permissions in Jira. | `JIRA_GET_MY_PERMISSIONS` |
| Get permissions | Retrieve all available Jira permissions. | `JIRA_GET_PERMISSIONS` |
| Get project roles | Retrieves all available roles for a Jira project. | `JIRA_GET_PROJECT_ROLES` |
| Action | What it does | Slug |
| ------------ | ---------------------------------------------------------------------------- | ------------------- |
| Get sprint | | `JIRA_GET_SPRINT` |
| List sprints | Retrieves paginated sprints from a Jira board with optional state filtering. | `JIRA_LIST_SPRINTS` |
| Action | What it does | Slug |
| --------------------- | ------------ | ---------------------------- |
| Get project templates | | `JIRA_GET_PROJECT_TEMPLATES` |
| Action | What it does | Slug |
| ------------------------------ | -------------------------------------------------------------------------------------------------- | ------------------------------------- |
| Get all issue type schemes | Retrieves all Jira issue type schemes with optional filtering and pagination. | `JIRA_GET_ALL_ISSUE_TYPE_SCHEMES` |
| Get issue link types | Retrieves all configured issue link types from Jira. | `JIRA_GET_ISSUE_LINK_TYPES` |
| Get issue types | Retrieves all Jira issue types available to the user using the modern API v3 endpoint. | `JIRA_GET_ISSUE_TYPES` |
| Get project type | Retrieves detailed information about a specific Jira project type by its key. | `JIRA_GET_PROJECT_TYPE` |
| Get universal avatar view type | Retrieve the default avatar image for a specific type (project, issuetype, or priority) from Jira. | `JIRA_GET_UNIVERSAL_AVATAR_VIEW_TYPE` |
| List project types | Retrieves all Jira project types available in the instance. | `JIRA_LIST_PROJECT_TYPES` |
| Action | What it does | Slug |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- |
| Find users | DEPRECATED: Use JIRA\_FIND\_USERS2 instead. | `JIRA_FIND_USERS` |
| Find users for picker | Find users for picker components by matching query against user attributes like display name and email. | `JIRA_FIND_USERS_FOR_PICKER` |
| Find users2 | Find users in Jira by query string, account ID, or property search. | `JIRA_FIND_USERS2` |
| Get all users | Retrieves all users from the Jira instance including active, inactive, app accounts, and system accounts, with pagination support. | `JIRA_GET_ALL_USERS` |
| Get current user | Retrieves detailed information about the currently authenticated Jira user. | `JIRA_GET_CURRENT_USER` |
| Action | What it does | Slug |
| -------------------- | ------------------------------------------------------------------ | --------------------------- |
| Get project versions | Retrieves all versions for a Jira project with optional expansion. | `JIRA_GET_PROJECT_VERSIONS` |
| Action | What it does | Slug |
| ------------------ | --------------------------------------------------------------- | ------------------------- |
| Get issue watchers | Retrieves users watching a Jira issue for update notifications. | `JIRA_GET_ISSUE_WATCHERS` |
| Action | What it does | Slug |
| ------------------ | ---------------------------------------------- | ------------------------- |
| Get issue worklogs | DEPRECATED: Use JIRA\_GET\_WORKLOG instead. | `JIRA_GET_ISSUE_WORKLOGS` |
| Get worklog | Retrieves worklogs for a specified Jira issue. | `JIRA_GET_WORKLOG` |
| Action | What it does | Slug |
| --------------- | ---------------------------------------------------------- | ---------------------- |
| Get transitions | Retrieves available workflow transitions for a Jira issue. | `JIRA_GET_TRANSITIONS` |
| Action | What it does | Slug |
| ------------------------------------ | ----------------------------------------------------------------------- | ------------------------------------------- |
| Get all statuses | Retrieves all issue statuses associated with workflows from Jira. | `JIRA_GET_ALL_STATUSES` |
| Get info | Retrieves runtime information for the Jira Service Management instance. | `JIRA_GET_INFO` |
| Get jql autocompletedata | Retrieve JQL autocomplete reference data. | `JIRA_GET_JQL_AUTOCOMPLETEDATA` |
| Get jql autocompletedata suggestions | Get JQL field auto-complete suggestions. | `JIRA_GET_JQL_AUTOCOMPLETEDATA_SUGGESTIONS` |
| Get server info | Retrieve Jira instance server information. | `JIRA_GET_SERVER_INFO` |
| Get votes | Fetches voting details for a Jira issue. | `JIRA_GET_VOTES` |
| Search approximate count | Count issues matching a JQL query using approximate count endpoint. | `JIRA_SEARCH_APPROXIMATE_COUNT` |
Agents can use 91 of the 102 Jira actions at this level: everything in **Read-only**, plus:
* Create and update issues
* Create and update comments
* View account details
* Create attachments
* Create links
* Send notifications
* Create sprints
* Create versions
* Create work logs
The 21 actions that this level adds to **Read-only**:
| Works on | Action | What it does | Slug |
| ------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------- |
| **Account details** | Who am I | | `JIRA_WHO_AM_I` |
| **Attachments** | Add attachment | Uploads and attaches a file to a Jira issue. | `JIRA_ADD_ATTACHMENT` |
| **Comments** | Add comment | Adds a comment using Atlassian Document Format (ADF) for rich text to an existing Jira issue. | `JIRA_ADD_COMMENT` |
| | Update comment | Updates text content or visibility of an existing Jira comment. | `JIRA_UPDATE_COMMENT` |
| **Issues** | Assign issue | Assigns a Jira issue to a user, default assignee, or unassigns. | `JIRA_ASSIGN_ISSUE` |
| | Bulk create issue | Creates multiple Jira issues (up to 50 per call) with full feature support including markdown, assignee resolution, and priority handling. | `JIRA_BULK_CREATE_ISSUE` |
| | Create issue | Creates a new Jira issue (e.g., bug, task, story) in a specified project. | `JIRA_CREATE_ISSUE` |
| | Edit issue | Updates an existing Jira issue with field values and operations. | `JIRA_EDIT_ISSUE` |
| | Move issue to sprint | Moves one or more Jira issues to a specified active sprint. | `JIRA_MOVE_ISSUE_TO_SPRINT` |
| | Transition issue | Transitions a Jira issue to a different workflow state, with support for transition name lookup and user assignment by email. | `JIRA_TRANSITION_ISSUE` |
| **Links** | Create issue link | Links two Jira issues using a specified link type with optional comment. | `JIRA_CREATE_ISSUE_LINK` |
| **Notifications** | Send notification for issue | Sends a customized email notification for a Jira issue. | `JIRA_SEND_NOTIFICATION_FOR_ISSUE` |
| **Sprints** | Create sprint | Creates a new sprint on a Jira board with optional start/end dates and goal. | `JIRA_CREATE_SPRINT` |
| **Versions** | Create version | Creates a new version for releases or milestones in a Jira project. | `JIRA_CREATE_VERSION` |
| **Watchers** | Add watcher to issue | Adds a user to an issue's watcher list by account ID. | `JIRA_ADD_WATCHER_TO_ISSUE` |
| | Remove watcher from issue | Removes a user from an issue's watcher list by account ID. | `JIRA_REMOVE_WATCHER_FROM_ISSUE` |
| **Work logs** | Add worklog | Add a worklog entry to a Jira issue. | `JIRA_ADD_WORKLOG` |
| **Other actions** | Analyse expression | Analyses Jira expressions for syntax validation, type checking, and complexity analysis. | `JIRA_ANALYSE_EXPRESSION` |
| | Create jql autocompletedata | Retrieves JQL autocomplete reference data including reserved words, field names, and function names. | `JIRA_CREATE_JQL_AUTOCOMPLETEDATA` |
| | Evaluate Jira expression | Evaluate Jira expressions using the enhanced search API. | `JIRA_EVALUATE_JIRA_EXPRESSION` |
| | Parse jql queries | Parse and validate JQL queries, returning their abstract syntax tree structure along with any errors or warnings. | `JIRA_PARSE_JQL_QUERIES` |
Agents can use 102 of the 102 Jira actions at this level: everything in **Read + write**, plus:
* Delete attachments
* Delete comments
* Create groups
* Delete issues
* Create projects
* Delete versions
* Delete work logs
The 11 actions that this level adds to **Read + write**:
| Works on | Action | What it does | Slug |
| --------------- | ----------------------------- | --------------------------------------------------------------------------------- | ------------------------------------ |
| **Attachments** | Delete attachment | | `JIRA_DELETE_ATTACHMENT` |
| **Comments** | Delete comment | Deletes a specific comment from a Jira issue using its ID and the issue's ID/key. | `JIRA_DELETE_COMMENT` |
| **Groups** | Create group | Creates a new group in Jira with the specified name. | `JIRA_CREATE_GROUP` |
| **Issues** | Delete issue | Permanently and irreversibly deletes a Jira issue by its ID or key. | `JIRA_DELETE_ISSUE` |
| **Projects** | Create project | Creates a new Jira project with required lead, template, and type configuration. | `JIRA_CREATE_PROJECT` |
| **Users** | Add user to group | Adds a user to a Jira group. | `JIRA_ADD_USER_TO_GROUP` |
| | Add users to project role | Adds users and optionally groups to a project role. | `JIRA_ADD_USERS_TO_PROJECT_ROLE` |
| | Remove user from group | Removes a user from a Jira group. | `JIRA_REMOVE_USER_FROM_GROUP` |
| | Remove user from project role | Removes a user or group from a project role. | `JIRA_REMOVE_USER_FROM_PROJECT_ROLE` |
| **Versions** | Delete version | Deletes a Jira version and optionally reassigns its issues. | `JIRA_DELETE_VERSION` |
| **Work logs** | Delete worklog | Deletes a worklog from a Jira issue with estimate adjustment options. | `JIRA_DELETE_WORKLOG` |
## Connect Jira
Before you start:
* You need a Jira account that you can sign in to.
* Your Squad subscription must be active. Squad does not connect apps while the subscription is not active.
Open **Settings** > **Integrations**.
On the **Connected apps** tab, click **+ Add integration**.
Find **Jira** in the catalog and click it. You can type the name in **Search the catalog…**.
Under **Default scope**, choose an access level. This level applies to every agent.
Click **Connect Jira**. The Jira sign-in page opens in a new tab.
Sign in to Jira and approve the request.
Check that it works: Jira shows under **YOUR CONNECTIONS**, with a row for the account and its access level.
## Change the access level
1. Under **YOUR CONNECTIONS**, find the Jira account.
2. Open the account menu (⋯) and click **Manage scope**.
3. Under **Default scope**, choose the new level.
4. Click **Save access**.
The change does not need a new sign-in. Agents get the new level from their next call.
## Set access for one agent
Every agent uses the account's level unless you set something else for it. You can narrow one agent to a lower level, or block it.
1. Under **YOUR CONNECTIONS**, open the account menu (⋯) on the Jira account.
2. Click **Manage scope**.
3. Under **Per-agent access**, find the agent.
4. Choose the **Default** option to follow the account's level, choose a lower level, or choose **No access**.
5. Click **Save access**.
An agent never gets more than the account's level, even if you choose a higher level for it. Changes apply from the agent's next call. An agent with **No access** does not see the account.
## Use more than one Jira account
Click **+ Account** on the Jira card to connect another account. Agents use the primary account unless they are asked to use a specific one.
* After you click **+ Account**, follow the connect steps above.
* Each account has its own access level.
* The first account you connect becomes the primary account. It shows **★ PRIMARY**.
* To change the primary account, open the account menu (⋯) and click **Make primary**.
* To tell accounts apart, open the account menu (⋯) and click **Rename**.
## Reconnect or disconnect
Reconnect when the connection has expired, or when you need to change what the account can reach on the Jira side:
1. Open the account menu (⋯) and click **Reconnect**.
2. Click **Reauthorize on Jira**.
3. Sign in to Jira and approve the request.
Reconnect signs in to the same account again. It does not add a second connection.
Open the account menu (⋯) on the Jira account and click **Disconnect**. Agents lose access to that account at once.
**Disconnect** acts at once, with no confirmation step. If it was the primary account, another connected Jira account becomes primary.
## Costs
Jira actions do not use Squad credits. Connected apps never use credits. For what does use credits, see [What Squad costs](/docs/costs).
## Troubleshooting
An agent reports that an action is not allowed on this account.
* Cause: the action is outside the account's access level, or outside the level you set for that agent.
* Fix: choose a higher level in **Manage scope**, or change the agent's row under **Per-agent access**.
An agent says it has no access to Jira, or it does not see the account.
* Cause: the agent is set to **No access** under **Per-agent access**, or the account is not connected.
* Fix: open **Manage scope** and change the agent's row. If the account is missing, connect it again.
Connecting or saving fails with "Your subscription isn't active."
* Cause: your Squad subscription is not active.
* Fix: resubscribe. See [Manage your subscription](/docs/billing).
An agent says the Jira connection has expired.
* Cause: the sign-in for that account is no longer valid.
* Fix: use **Reconnect** on the account.
## Common questions
Each Jira account has an access level: **Read-only**, **Read + write**, and **Full access**. Squad refuses any agent action outside that level. You can also narrow or block single agents under **Per-agent access**.
Click **+ Account** on the Jira card to connect another account. Agents use the primary account unless they are asked to use a specific one.
Open the account menu (⋯) on the Jira account and click **Disconnect**. Agents lose access to that account at once.
## Related pages
Use this when an action you need is not in this app.