> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira

> Connect Jira to your Atako agents — 24 read and 15 write actions.

Let your agents work in Jira — search with JQL, create and update issues, comment, log work, and transition issues through your workflows.

## Connection

* **Authentication**: API key (email:api\_token).
* **Required settings**:
  * **Site name** — yourcompany in yourcompany.atlassian.net

<Note>
  Go to id.atlassian.com → Security → API tokens ([https://id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens)) → Create API token → name it and copy it. The token inherits your Jira permissions — an account with browse/create/edit rights on the target projects is enough. Enter the credential as [your-email@company.com](mailto:your-email@company.com):the\_api\_token (email and token joined by a colon).

  See [Jira's documentation](https://id.atlassian.com/manage-profile/security/api-tokens).
</Note>

## Read actions (24)

| Action                      | Description                                                                      |
| --------------------------- | -------------------------------------------------------------------------------- |
| `get_attachment`            | Fetch the metadata of an attachment (filename, size, author, download URL).      |
| `get_create_issue_metadata` | Fetch the projects, issue types and fields available when creating issues.       |
| `get_edit_issue_metadata`   | Fetch the fields that can be edited on a given issue.                            |
| `get_field`                 | Look up a field by its id (e.g. customfield\_10011).                             |
| `get_issue`                 | Fetch a single issue by id or key (e.g. PROJ-123).                               |
| `get_issue_changelog`       | Fetch the change history of an issue (paginated).                                |
| `get_issue_type`            | Fetch a single issue type by id.                                                 |
| `get_myself`                | Fetch the profile of the authenticated user (accountId, display name, timezone). |
| `get_priority`              | Fetch a single issue priority by id.                                             |
| `get_project`               | Fetch a single project by id or key.                                             |
| `get_status`                | Fetch a single workflow status by id or name.                                    |
| `get_user`                  | Fetch a user by accountId.                                                       |
| `list_fields`               | List all system and custom fields with their ids and types.                      |
| `list_issue_comments`       | List the comments on an issue (paginated).                                       |
| `list_issue_link_types`     | List the issue link types available on the site.                                 |
| `list_issue_types`          | List all issue types visible to the authenticated user.                          |
| `list_priorities`           | List issue priorities (paginated).                                               |
| `list_projects`             | List projects visible to the authenticated user (paginated, filterable).         |
| `list_statuses`             | List all workflow statuses visible to the authenticated user.                    |
| `list_transitions`          | List the workflow transitions currently available for an issue.                  |
| `list_watchers`             | List the users watching an issue.                                                |
| `list_worklogs`             | List the worklog entries of an issue (paginated).                                |
| `search_issues`             | Search issues with a JQL query (paginated).                                      |
| `search_users`              | Search users by display name or email (paginated).                               |

## Write actions (15)

| Action              | Description                                                  |
| ------------------- | ------------------------------------------------------------ |
| `add_comment`       | Add a comment to an issue.                                   |
| `add_watcher`       | Add a user as a watcher of an issue.                         |
| `add_worklog`       | Log time spent on an issue.                                  |
| `assign_issue`      | Assign an issue to a user (omit accountId to unassign).      |
| `create_issue`      | Create an issue in a project.                                |
| `create_issue_link` | Link two issues together (e.g. "Blocks", "Relates").         |
| `delete_attachment` | Delete an attachment from an issue.                          |
| `delete_comment`    | Delete a comment from an issue.                              |
| `delete_issue`      | Delete an issue (optionally including its sub-tasks).        |
| `delete_issue_link` | Delete a link between two issues.                            |
| `delete_worklog`    | Delete a worklog entry from an issue.                        |
| `remove_watcher`    | Remove a user from the watchers of an issue.                 |
| `transition_issue`  | Move an issue through its workflow by applying a transition. |
| `update_comment`    | Update the text of an existing comment.                      |
| `update_issue`      | Update fields of an existing issue.                          |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.