Jira — ведущая платформа управления проектами и трекинга задач от Atlassian, помогающая командам планировать, отслеживать и вести гибкую разработку программного обеспечения. Jira поддерживает методологии Scrum и Kanban с настраиваемыми досками, воркфлоу и расширенной отчётностью.
Интеграция Jira в AACFlow позволяет:
- Управление задачами: создавайте, получайте, обновляйте, удаляйте и массово читайте задачи в проектах Jira
- Смена статусов: программно перемещайте задачи между этапами воркфлоу
- Назначение исполнителей: устанавливайте или меняйте исполнителей задач
- Поиск задач: используйте JQL (Jira Запрос Language) для поиска и фильтрации задач
- Управление комментариями: добавляйте, получайте, обновляйте и удаляйте комментарии к задачам
- Работа с вложениями: загружайте, получайте и удаляйте файловые вложения у задач
- Учёт работы: добавляйте, получайте, обновляйте и удаляйте worklog-записи для учёта времени
- Связывание задач: создавайте и удаляйте связи между задачами для установления отношений
- Управление наблюдателями: добавляйте и удаляйте наблюдателей задач
- Получение информации о пользователях: получайте данные пользователей из вашего инстанса Jira
Интеграция Jira в AACFlow позволяет вашим AI-агентам взаимодействовать с процессами управления проектами в рамках автоматизированных сценариев. Агенты могут создавать задачи из внешних триггеров, обновлять статусы, отслеживать прогресс и управлять данными проекта — обеспечивая интеллектуальную автоматизацию управления проектами.
Инструкции по использованию
Интегрируйте Jira в рабочий процесс. Может читать, писать и обновлять issues. Может также запускать рабочие процессы на основе вебхука Jira events.
Инструменты
jira_retrieve
Получить подробную информацию about a specific Jira issue
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи Jira to retrieve (e.g., PROJ-123) |
includeAttachments | boolean | Нет | Загрузить вложение file contents and include them as files in the output |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
id | string | Issue ID |
key | string | Issue key (e.g., PROJ-123) |
self | string | REST API URL for this issue |
summary | string | Issue summary |
description | string | Issue description text (extracted from ADF) |
status | object | Issue status |
↳ id | string | Status ID |
↳ name | string | Status name (e.g., Open, In Progress, Done) |
↳ description | string | Status description |
↳ statusCategory | object | Status category grouping |
↳ id | number | Status category ID |
↳ key | string | Status category key (e.g., new, indeterminate, done) |
↳ name | string | Status category name (e.g., To Do, In Progress, Done) |
↳ colorName | string | Status category color (e.g., blue-gray, yellow, green) |
statusName | string | Issue status name (e.g., Open, In Progress, Done) |
issuetype | object | Issue type |
↳ id | string | Issue type ID |
↳ name | string | Issue type name (e.g., Task, Bug, Story, Epic) |
↳ description | string | Issue type description |
↳ subtask | boolean | Произошла ли эта is a subtask type |
↳ iconUrl | string | URL to the issue type icon |
project | object | Project the issue belongs to |
↳ id | string | Project ID |
↳ key | string | Project key (e.g., PROJ) |
↳ name | string | Project name |
↳ projectTypeKey | string | Project type key (e.g., software, business) |
priority | object | Issue priority |
↳ id | string | Priority ID |
↳ name | string | Priority name (e.g., Highest, High, Medium, Low, Lowest) |
↳ iconUrl | string | URL to the priority icon |
assignee | object | Assigned user |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
assigneeName | string | Assignee display name or account ID |
reporter | object | Reporter user |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
creator | object | Issue creator |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
labels | array | Issue labels |
components | array | Issue components |
↳ id | string | Component ID |
↳ name | string | Component name |
↳ description | string | Component description |
fixVersions | array | Fix versions |
↳ id | string | Version ID |
↳ name | string | Version name |
↳ released | boolean | Произошла ли version is released |
↳ releaseDate | string | Release date (YYYY-MM-DD) |
resolution | object | Issue resolution |
↳ id | string | Resolution ID |
↳ name | string | Resolution name (e.g., Fixed, Duplicate, Won't Fix) |
↳ description | string | Resolution description |
duedate | string | Due date (YYYY-MM-DD) |
created | string | ISO 8601 timestamp when the issue was created |
updated | string | ISO 8601 timestamp when the issue was last updated |
resolutiondate | string | ISO 8601 timestamp when the issue was resolved |
timetracking | object | Time tracking information |
↳ originalEstimate | string | Original estimate in human-readable format (e.g., 1w 2d) |
↳ remainingEstimate | string | Remaining estimate in human-readable format |
↳ timeSpent | string | Time spent in human-readable format |
↳ originalEstimateSeconds | number | Original estimate in seconds |
↳ remainingEstimateSeconds | number | Remaining estimate in seconds |
↳ timeSpentSeconds | number | Time spent in seconds |
parent | object | Parent issue (for subtasks) |
↳ id | string | Parent issue ID |
↳ key | string | Parent issue key |
↳ summary | string | Parent issue summary |
issuelinks | array | Linked issues |
↳ id | string | Issue link ID |
↳ type | object | Link type information |
↳ id | string | Link type ID |
↳ name | string | Link type name (e.g., Blocks, Relates) |
↳ inward | string | Inward description (e.g., is blocked by) |
↳ outward | string | Outward description (e.g., blocks) |
↳ inwardIssue | object | Inward linked issue |
↳ id | string | Issue ID |
↳ key | string | Issue key |
↳ statusName | string | Issue status name |
↳ summary | string | Issue summary |
↳ outwardIssue | object | Outward linked issue |
↳ id | string | Issue ID |
↳ key | string | Issue key |
↳ statusName | string | Issue status name |
↳ summary | string | Issue summary |
subtasks | array | Subtask issues |
↳ id | string | Subtask issue ID |
↳ key | string | Subtask issue key |
↳ summary | string | Subtask summary |
↳ statusName | string | Subtask status name |
↳ issueTypeName | string | Subtask issue type name |
votes | object | Vote information |
↳ votes | number | Number of votes |
↳ hasVoted | boolean | Произошла ли current user has voted |
watches | object | Watch information |
↳ watchCount | number | Number of watchers |
↳ isWatching | boolean | Произошла ли current user is watching |
comments | array | Issue comments (fetched separately) |
↳ id | string | Comment ID |
↳ body | string | Comment body text (extracted from ADF) |
↳ author | object | Comment author |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
↳ authorName | string | Comment author display name |
↳ updateAuthor | object | User who last updated the comment |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
↳ created | string | ISO 8601 timestamp when the comment was created |
↳ updated | string | ISO 8601 timestamp when the comment was last updated |
↳ visibility | object | Comment visibility restriction |
↳ type | string | Restriction type (e.g., role, group) |
↳ value | string | Restriction value (e.g., Administrators) |
worklogs | array | Issue worklogs (fetched separately) |
↳ id | string | Worklog ID |
↳ author | object | Worklog author |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
↳ authorName | string | Worklog author display name |
↳ updateAuthor | object | User who last updated the worklog |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
↳ comment | string | Worklog comment text |
↳ started | string | ISO 8601 timestamp when the work started |
↳ timeSpent | string | Time spent in human-readable format (e.g., 3h 20m) |
↳ timeSpentSeconds | number | Time spent in seconds |
↳ created | string | ISO 8601 timestamp when the worklog was created |
↳ updated | string | ISO 8601 timestamp when the worklog was last updated |
attachments | array | Issue attachments |
↳ id | string | Attachment ID |
↳ filename | string | Attachment file name |
↳ mimeType | string | MIME type of the attachment |
↳ size | number | File size in bytes |
↳ content | string | URL to download the attachment content |
↳ thumbnail | string | URL to the attachment thumbnail |
↳ author | object | Attachment author |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
↳ authorName | string | Attachment author display name |
↳ created | string | ISO 8601 timestamp when the attachment was created |
issueKey | string | Issue key (e.g., PROJ-123) |
issue | json | Complete raw Jira issue object from the API |
files | file[] | Downloaded attachment files (only when includeAttachments is true) |
jira_update
Обновить Jira issue
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи Jira to update (e.g., PROJ-123) |
summary | string | Нет | New summary for the issue |
description | string | Нет | New description for the issue |
priority | string | Нет | New priority ID or name for the issue (e.g., "High") |
assignee | string | Нет | New assignee account ID for the issue |
labels | json | Нет | Labels to set on the issue (array of label name strings) |
components | json | Нет | Components to set on the issue (array of component name strings) |
duedate | string | Нет | Due date for the issue (format: YYYY-MM-DD) |
fixVersions | json | Нет | Fix versions to set (array of version name strings) |
environment | string | Нет | Environment information for the issue |
customFieldId | string | Нет | Custom field ID to update (e.g., customfield_10001) |
customFieldValue | string | Нет | Value for the custom field |
notifyUsers | boolean | Нет | Whether to send email notifications about this update (default: true) |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
success | boolean | Operation success status |
issueKey | string | Updated issue key (e.g., PROJ-123) |
summary | string | Issue summary after update |
jira_write
Создать новый Jira issue
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
projectId | string | Да | Jira project key (e.g., PROJ) |
summary | string | Да | Summary for the issue |
description | string | Нет | Description for the issue |
priority | string | Нет | Priority ID or name for the issue (e.g., "10000" or "High") |
assignee | string | Нет | Assignee account ID for the issue |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
issueType | string | Да | Type of issue to create (e.g., Task, Story, Bug, Epic, Sub-task) |
parent | json | Нет | Parent issue key for creating subtasks (e.g., { "key": "PROJ-123" }) |
labels | array | Нет | Labels for the issue (array of label names) |
components | array | Нет | Components for the issue (array of component names) |
duedate | string | Нет | Due date for the issue (format: YYYY-MM-DD) |
fixVersions | array | Нет | Fix versions for the issue (array of version names) |
reporter | string | Нет | Reporter account ID for the issue |
environment | string | Нет | Environment information for the issue |
customFieldId | string | Нет | Custom field ID (e.g., customfield_10001) |
customFieldValue | string | Нет | Value for the custom field |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
id | string | Created issue ID |
issueKey | string | Created issue key (e.g., PROJ-123) |
self | string | REST API URL for the created issue |
summary | string | Issue summary |
success | boolean | Произошла ли issue was created successfully |
url | string | URL to the created issue in Jira |
assigneeId | string | Account ID of the assigned user (null if no assignee was set) |
jira_bulk_read
Получить multiple Jira issues from a project in bulk
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
projectId | string | Да | Jira project key (e.g., PROJ) |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
total | number | Total number of issues in the project (may not always be available) |
issues | array | Массив Jira issues |
↳ id | string | Issue ID |
↳ key | string | Issue key (e.g., PROJ-123) |
↳ self | string | REST API URL for this issue |
↳ summary | string | Issue summary |
↳ description | string | Issue description text |
↳ status | object | Issue status |
↳ id | string | Status ID |
↳ name | string | Status name |
↳ issuetype | object | Issue type |
↳ id | string | Issue type ID |
↳ name | string | Issue type name |
↳ priority | object | Issue priority |
↳ id | string | Priority ID |
↳ name | string | Priority name |
↳ assignee | object | Assigned user |
↳ accountId | string | Atlassian account ID |
↳ displayName | string | Display name |
↳ created | string | ISO 8601 creation timestamp |
↳ updated | string | ISO 8601 last updated timestamp |
nextPageToken | string | Cursor token for the next page. Null when no more results. |
isLast | boolean | Произошла ли эта is the last page of results |
jira_delete_issue
Удалить Jira issue
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи Jira to delete (e.g., PROJ-123) |
deleteSubtasks | boolean | Нет | Whether to delete subtasks. If false, parent issues with subtasks cannot be deleted. |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
success | boolean | Operation success status |
issueKey | string | Deleted issue key |
jira_assign_issue
Assign a Jira issue to a user
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи Jira to assign (e.g., PROJ-123) |
accountId | string | Да | Account ID of the user to assign the issue to. Use "-1" for automatic assignment or null to unassign. |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
success | boolean | Operation success status |
issueKey | string | Issue key that was assigned |
assigneeId | string | Account ID of the assignee (use "-1" for auto-assign, null to unassign) |
jira_transition_issue
Move a Jira issue between workflow statuses (e.g., To Do -> In Progress)
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи Jira to transition (e.g., PROJ-123) |
transitionId | string | Да | ID of the transition to execute (e.g., "11" for "To Do", "21" for "In Progress") |
comment | string | Нет | Optional comment to add when transitioning the issue |
resolution | string | Нет | Resolution name to set during transition (e.g., "Fixed", "Won't Fix") |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
success | boolean | Operation success status |
issueKey | string | Issue key that was transitioned |
transitionId | string | Applied transition ID |
transitionName | string | Applied transition name |
toStatus | object | Target status after transition |
↳ id | string | Status ID |
↳ name | string | Status name |
jira_search_issues
Поиск Jira issues using JQL (Jira Запрос Language)
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
jql | string | Да | JQL query string to search for issues (e.g., "project = PROJ AND status = Open") |
nextPageToken | string | Нет | Cursor token for the next page of results. Omit for the first page. |
maxResults | number | Нет | Maximum number of results to return per page (default: 50) |
fields | array | Нет | Массив field names to return (default: all navigable). Use "*all" for every field. |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
issues | array | Массив matching issues |
↳ id | string | Issue ID |
↳ key | string | Issue key (e.g., PROJ-123) |
↳ self | string | REST API URL for this issue |
↳ summary | string | Issue summary |
↳ description | string | Issue description text (extracted from ADF) |
↳ status | object | Issue status |
↳ id | string | Status ID |
↳ name | string | Status name (e.g., Open, In Progress, Done) |
↳ description | string | Status description |
↳ statusCategory | object | Status category grouping |
↳ id | number | Status category ID |
↳ key | string | Status category key (e.g., new, indeterminate, done) |
↳ name | string | Status category name (e.g., To Do, In Progress, Done) |
↳ colorName | string | Status category color (e.g., blue-gray, yellow, green) |
↳ statusName | string | Issue status name (e.g., Open, In Progress, Done) |
↳ issuetype | object | Issue type |
↳ id | string | Issue type ID |
↳ name | string | Issue type name (e.g., Task, Bug, Story, Epic) |
↳ description | string | Issue type description |
↳ subtask | boolean | Произошла ли эта is a subtask type |
↳ iconUrl | string | URL to the issue type icon |
↳ project | object | Project the issue belongs to |
↳ id | string | Project ID |
↳ key | string | Project key (e.g., PROJ) |
↳ name | string | Project name |
↳ projectTypeKey | string | Project type key (e.g., software, business) |
↳ priority | object | Issue priority |
↳ id | string | Priority ID |
↳ name | string | Priority name (e.g., Highest, High, Medium, Low, Lowest) |
↳ iconUrl | string | URL to the priority icon |
↳ assignee | object | Assigned user |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
↳ assigneeName | string | Assignee display name or account ID |
↳ reporter | object | Reporter user |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
↳ labels | array | Issue labels |
↳ components | array | Issue components |
↳ id | string | Component ID |
↳ name | string | Component name |
↳ description | string | Component description |
↳ resolution | object | Issue resolution |
↳ id | string | Resolution ID |
↳ name | string | Resolution name (e.g., Fixed, Duplicate, Won't Fix) |
↳ description | string | Resolution description |
↳ duedate | string | Due date (YYYY-MM-DD) |
↳ created | string | ISO 8601 timestamp when the issue was created |
↳ updated | string | ISO 8601 timestamp when the issue was last updated |
nextPageToken | string | Cursor token for the next page. Null when no more results. |
isLast | boolean | Произошла ли эта is the last page of results |
total | number | Total number of matching issues (may not always be available) |
jira_add_comment
Добавить комментарий to a Jira issue
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи Jira to add comment to (e.g., PROJ-123) |
body | string | Да | Comment body text |
visibility | json | Нет | Restrict comment visibility. Object with "type" ("role" or "group") and "value" (role/group name). |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
success | boolean | Operation success status |
issueKey | string | Issue key the comment was added to |
commentId | string | Created comment ID |
body | string | Comment text content |
author | object | Comment author |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
created | string | ISO 8601 timestamp when the comment was created |
updated | string | ISO 8601 timestamp when the comment was last updated |
jira_get_comments
Получить все comments from a Jira issue
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи Jira to get comments from (e.g., PROJ-123) |
startAt | number | Нет | Index of the first comment to return (default: 0) |
maxResults | number | Нет | Maximum number of comments to return (default: 50) |
orderBy | string | Нет | Sort order for comments: "-created" for newest first, "created" for oldest first |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
issueKey | string | Issue key |
total | number | Total number of comments |
startAt | number | Pagination start index |
maxResults | number | Maximum results per page |
comments | array | Массив comments |
↳ id | string | Comment ID |
↳ body | string | Comment body text (extracted from ADF) |
↳ author | object | Comment author |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
↳ authorName | string | Comment author display name |
↳ updateAuthor | object | User who last updated the comment |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
↳ created | string | ISO 8601 timestamp when the comment was created |
↳ updated | string | ISO 8601 timestamp when the comment was last updated |
↳ visibility | object | Comment visibility restriction |
↳ type | string | Restriction type (e.g., role, group) |
↳ value | string | Restriction value (e.g., Administrators) |
jira_update_comment
Обновитьn existing comment on a Jira issue
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи Jira containing the comment (e.g., PROJ-123) |
commentId | string | Да | ID of the comment to update |
body | string | Да | Updated comment text |
visibility | json | Нет | Restrict comment visibility. Object with "type" ("role" or "group") and "value" (role/group name). |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
success | boolean | Operation success status |
issueKey | string | Issue key |
commentId | string | Updated comment ID |
body | string | Updated comment text |
author | object | Comment author |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
created | string | ISO 8601 timestamp when the comment was created |
updated | string | ISO 8601 timestamp when the comment was last updated |
jira_delete_comment
Удалить comment from a Jira issue
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи Jira containing the comment (e.g., PROJ-123) |
commentId | string | Да | ID of the comment to delete |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
success | boolean | Operation success status |
issueKey | string | Issue key |
commentId | string | Deleted comment ID |
jira_get_attachments
Получить все attachments from a Jira issue
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи Jira to get attachments from (e.g., PROJ-123) |
includeAttachments | boolean | Нет | Загрузить вложение file contents and include them as files in the output |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
issueKey | string | Issue key |
attachments | array | Массив attachments |
↳ id | string | Attachment ID |
↳ filename | string | Attachment file name |
↳ mimeType | string | MIME type of the attachment |
↳ size | number | File size in bytes |
↳ content | string | URL to download the attachment content |
↳ thumbnail | string | URL to the attachment thumbnail |
↳ author | object | Attachment author |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
↳ authorName | string | Attachment author display name |
↳ created | string | ISO 8601 timestamp when the attachment was created |
files | file[] | Downloaded attachment files (only when includeAttachments is true) |
jira_add_attachment
Добавить attachments to a Jira issue
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи Jira to add attachments to (e.g., PROJ-123) |
files | file[] | Да | Files to attach to the Jira issue |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
issueKey | string | Issue key |
attachments | array | Uploaded attachments |
↳ id | string | Attachment ID |
↳ filename | string | Attachment file name |
↳ mimeType | string | MIME type |
↳ size | number | File size in bytes |
↳ content | string | URL to download the attachment |
attachmentIds | array | Массив attachment IDs |
files | file[] | Uploaded attachment files |
jira_delete_attachment
Удалитьn attachment from a Jira issue
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
attachmentId | string | Да | ID of the attachment to delete |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
success | boolean | Operation success status |
attachmentId | string | Deleted attachment ID |
jira_add_worklog
Добавить a time tracking worklog entry to a Jira issue
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи Jira to add worklog to (e.g., PROJ-123) |
timeSpentSeconds | number | Да | Time spent in seconds |
comment | string | Нет | Optional comment for the worklog entry |
started | string | Нет | Optional start time in ISO format (defaults to current time) |
visibility | json | Нет | Restrict worklog visibility. Object with "type" ("role" or "group") and "value" (role/group name). |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
success | boolean | Operation success status |
issueKey | string | Issue key the worklog was added to |
worklogId | string | Created worklog ID |
timeSpent | string | Time spent in human-readable format (e.g., 3h 20m) |
timeSpentSeconds | number | Time spent in seconds |
author | object | Worklog author |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
started | string | ISO 8601 timestamp when the work started |
created | string | ISO 8601 timestamp when the worklog was created |
jira_get_worklogs
Получить все worklog entries from a Jira issue
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи Jira to get worklogs from (e.g., PROJ-123) |
startAt | number | Нет | Index of the first worklog to return (default: 0) |
maxResults | number | Нет | Maximum number of worklogs to return (default: 50) |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
issueKey | string | Issue key |
total | number | Total number of worklogs |
startAt | number | Pagination start index |
maxResults | number | Maximum results per page |
worklogs | array | Массив worklogs |
↳ id | string | Worklog ID |
↳ author | object | Worklog author |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
↳ authorName | string | Worklog author display name |
↳ updateAuthor | object | User who last updated the worklog |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
↳ comment | string | Worklog comment text |
↳ started | string | ISO 8601 timestamp when the work started |
↳ timeSpent | string | Time spent in human-readable format (e.g., 3h 20m) |
↳ timeSpentSeconds | number | Time spent in seconds |
↳ created | string | ISO 8601 timestamp when the worklog was created |
↳ updated | string | ISO 8601 timestamp when the worklog was last updated |
jira_update_worklog
Обновитьn existing worklog entry on a Jira issue
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи Jira containing the worklog (e.g., PROJ-123) |
worklogId | string | Да | ID of the worklog entry to update |
timeSpentSeconds | number | Нет | Time spent in seconds |
comment | string | Нет | Optional comment for the worklog entry |
started | string | Нет | Optional start time in ISO format |
visibility | json | Нет | Restrict worklog visibility. Object with "type" ("role" or "group") and "value" (role/group name). |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
success | boolean | Operation success status |
issueKey | string | Issue key |
worklogId | string | Updated worklog ID |
timeSpent | string | Human-readable time spent (e.g., "3h 20m") |
timeSpentSeconds | number | Time spent in seconds |
comment | string | Worklog comment text |
author | object | Worklog author |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
updateAuthor | object | User who last updated the worklog |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
started | string | Worklog start time in ISO format |
created | string | Worklog creation time |
updated | string | Worklog last update time |
jira_delete_worklog
Удалить worklog entry from a Jira issue
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи Jira containing the worklog (e.g., PROJ-123) |
worklogId | string | Да | ID of the worklog entry to delete |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
success | boolean | Operation success status |
issueKey | string | Issue key |
worklogId | string | Deleted worklog ID |
jira_create_issue_link
Создать a link relationship between two Jira issues
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
inwardIssueKey | string | Да | Ключ задачи Jira for the inward issue (e.g., PROJ-123) |
outwardIssueKey | string | Да | Ключ задачи Jira for the outward issue (e.g., PROJ-456) |
linkType | string | Да | The type of link relationship (e.g., "Blocks", "Relates to", "Duplicates") |
comment | string | Нет | Optional comment to add to the issue link |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
success | boolean | Operation success status |
inwardIssue | string | Inward issue key |
outwardIssue | string | Outward issue key |
linkType | string | Type of issue link |
linkId | string | Created link ID |
jira_delete_issue_link
Удалить link between two Jira issues
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
linkId | string | Да | ID of the issue link to delete |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
success | boolean | Operation success status |
linkId | string | Deleted link ID |
jira_add_watcher
Добавить a watcher to a Jira issue to receive notifications about updates
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи Jira to add watcher to (e.g., PROJ-123) |
accountId | string | Да | Account ID of the user to add as watcher |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
success | boolean | Operation success status |
issueKey | string | Issue key |
watcherAccountId | string | Added watcher account ID |
jira_remove_watcher
Remove a watcher from a Jira issue
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи Jira to remove watcher from (e.g., PROJ-123) |
accountId | string | Да | Account ID of the user to remove as watcher |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
success | boolean | Operation success status |
issueKey | string | Issue key |
watcherAccountId | string | Removed watcher account ID |
jira_get_users
Получить Jira users. If an account ID — это provided, returns a single user. Otherwise, returns a list of all users.
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
accountId | string | Нет | Optional account ID to get a specific user. Если не предоставлен, returns all users. |
startAt | number | Нет | The index of the first user to return (for постраничная выборка, default: 0) |
maxResults | number | Нет | Maximum number of users to return (default: 50) |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
users | array | Массив Jira users |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
↳ avatarUrls | json | User avatar URLs in multiple sizes (16x16, 24x24, 32x32, 48x48) |
↳ self | string | REST API URL for this user |
total | number | Total number of users returned |
startAt | number | Pagination start index |
maxResults | number | Maximum results per page |
jira_search_users
Поиск пользователей Jira по email address или display name. Returns matching users С помощьюir accountId, displayName, и emailAddress.
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
domain | string | Да | Ваш домен Jira (e.g., yourcompany.atlassian.net) |
query | string | Да | A query string to search for users. Can be an email address, display name, or partial match. |
maxResults | number | Нет | Maximum number of users to return (default: 50, max: 1000) |
startAt | number | Нет | The index of the first user to return (for постраничная выборка, default: 0) |
cloudId | string | Нет | Jira Cloud ID for the instance. Если не предоставлен, it будет получен using the domain. |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
ts | string | ISO 8601 timestamp of the operation |
users | array | Массив matching Jira users |
↳ accountId | string | Atlassian account ID of the user |
↳ displayName | string | Display name of the user |
↳ active | boolean | Произошла ли user account is active |
↳ emailAddress | string | Email address of the user |
↳ accountType | string | Type of account (e.g., atlassian, app, customer) |
↳ avatarUrl | string | URL to the user avatar (48x48) |
↳ timeZone | string | User timezone |
↳ self | string | REST API URL for this user |
total | number | Number of users returned in this page (may be less than total matches) |
startAt | number | Pagination start index |
maxResults | number | Maximum results per page |