Jira
jiraA tool for bug tracking, issue tracking, and agile project management.
Acciones disponibles (46)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Add AttachmentJIRA_ADD_ATTACHMENTAcciónUploads and attaches a file to a jira issue.
JIRA_ADD_ATTACHMENTAcciónUploads and attaches a file to a jira issue.
Parámetros de entrada
issue_keystringObligatorioThe ID or key of the Jira issue to which the attachment will be added.
file_to_uploadobjectObligatorioFile to be attached to the Jira issue. Supports various formats including images, documents, and other file types.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Add CommentJIRA_ADD_COMMENTAcciónAdds a comment using atlassian document format (adf) for rich text to an existing jira issue.
JIRA_ADD_COMMENTAcciónAdds a comment using atlassian document format (adf) for rich text to an existing jira issue.
Parámetros de entrada
commentstringObligatorioThe comment text. Supports Markdown formatting including **bold**, *italic*, `code`, links [text](url), lists, and @mentions.
issue_id_or_keystringObligatorioThe ID or key of the issue to add the comment to.
visibility_typestringSpecifies the type of visibility restriction for the comment. Valid values are 'group' or 'role'. If this field is used, `visibility_value` must also be provided.
visibility_valuestringName of the group or role that can view the comment (required if visibility_type is set).
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Add Watcher to IssueJIRA_ADD_WATCHER_TO_ISSUEAcciónAdds a user to an issue's watcher list by account id.
JIRA_ADD_WATCHER_TO_ISSUEAcciónAdds a user to an issue's watcher list by account id.
Parámetros de entrada
account_idstringObligatorioThe Atlassian Account ID (accountId) of the user to be added as a watcher. Important: Usernames cannot be used due to Jira API privacy changes; the accountId is required.
issue_id_or_keystringObligatorioThe ID (a numerical identifier, e.g., '10000') or key (a project-prefixed string, e.g., 'PROJ-123') of the Jira issue to which the watcher will be added.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Assign IssueJIRA_ASSIGN_ISSUEAcciónAssigns a jira issue to a user, default assignee, or unassigns; supports email/name lookup.
JIRA_ASSIGN_ISSUEAcciónAssigns a jira issue to a user, default assignee, or unassigns; supports email/name lookup.
Parámetros de entrada
account_idstringThe Atlassian Account ID of the user to assign the issue to. Use `'-1'` (as a string) to assign to the project's default assignee. Provide `None` (Python null, which translates to JSON null) or omit this field to unassign the issue. Takes precedence over assignee_name if provided.
assignee_namestringName of the user to assign the issue to. Can be either an email address (e.g., 'john@company.com') or display name (e.g., 'John Doe'). The system will auto-detect the type and search accordingly. Ignored if account_id is also provided.
issue_id_or_keystringObligatorioThe ID or key of the issue to be assigned.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Bulk Create IssuesJIRA_BULK_CREATE_ISSUEAcciónCreates multiple jira issues (up to 50 per call) with full feature support including markdown, assignee resolution, and priority handling.
JIRA_BULK_CREATE_ISSUEAcciónCreates multiple jira issues (up to 50 per call) with full feature support including markdown, assignee resolution, and priority handling.
Parámetros de entrada
issuesobject[]ObligatorioList of issues to be created (1 to 50 per request). Each issue definition follows the same structure as the single create issue action.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create IssueJIRA_CREATE_ISSUEAcciónCreates a new jira issue (e.g., bug, task, story) in a specified project.
JIRA_CREATE_ISSUEAcciónCreates a new jira issue (e.g., bug, task, story) in a specified project.
Parámetros de entrada
labelsstring[]List of labels to categorize the issue; new labels are created if they don't exist.
summarystringObligatorioBrief, descriptive title for the issue.
assigneestringAccount ID of the user to assign the issue to. If unspecified, the project's default assignee may be used. Takes precedence over assignee_name if both are provided.
due_datestringExpected resolution date in YYYY-MM-DD format.
prioritystringPriority level for the issue. Can be either a priority ID (e.g., '1', '2') or priority name (e.g., 'High', 'Medium', 'Low'). Only set if the priority field is available on the project's create screen.
reporterstringAccount ID of the user reporting the issue. Defaults to the API request user if unspecified.
versionsstring[]List of IDs for versions affected by this issue; versions must exist in the project.
sprint_idintegerID of the sprint to assign this issue to. The issue will be added to the specified sprint if provided.
componentsstring[]List of component IDs (e.g., '10000'); components must already exist in the project.
issue_typestringType of the issue (e.g., 'Bug', 'Task'); must be a valid type name for the project and is case-sensitive. Defaults to 'Task'.
descriptionstringDetailed description of the issue. Supports Markdown formatting including **bold**, *italic*, `code`, links [text](url), and lists.
environmentstringEnvironment details. Supports Markdown formatting including **bold**, *italic*, `code`, links [text](url), and lists.
project_keystringObligatorioKey of the Jira project (e.g., 'PROJ').
fix_versionsstring[]List of IDs for versions where the issue is/will be fixed; versions must exist in the project.
assignee_namestringName or email of the user to assign the issue to. Can be either an email address (e.g., 'john@company.com') or display name (e.g., 'John Doe'). The system will auto-detect the type and search accordingly. Ignored if assignee (account ID) is also provided.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Link IssuesJIRA_CREATE_ISSUE_LINKAcciónLinks two jira issues using a specified link type with optional comment.
JIRA_CREATE_ISSUE_LINKAcciónLinks two jira issues using a specified link type with optional comment.
Parámetros de entrada
commentstringAn optional textual comment to add to the created issue link, providing additional context.
link_typestringObligatorioThe specific type of relationship to establish between the issues (e.g., 'Blocks', 'Relates to', 'Duplicates').
inward_issue_keystringObligatorioThe key of the issue that initiates the link relationship (the 'source' issue). For example, if creating a 'Blocks' link from Issue A to Issue B, Issue A is the inward issue.
outward_issue_keystringObligatorioThe key of the issue that is the target of the link relationship (the 'destination' issue). For example, if creating a 'Blocks' link from Issue A to Issue B, Issue B is the outward issue.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create ProjectJIRA_CREATE_PROJECTAcciónCreates a new jira project with required lead, template, and type configuration.
JIRA_CREATE_PROJECTAcciónCreates a new jira project with required lead, template, and type configuration.
Parámetros de entrada
keystringObligatorioUnique key for the project. Must be unique across all Jira projects.
urlstringOptional URL for the project, like a Confluence space link or external website.
namestringObligatorioHuman-readable name for the project.
avatar_idintegerOptional ID of an existing avatar for the project.
category_idintegerOptional ID of an existing project category.
descriptionstringOptional detailed textual description of the project.
assignee_typestringenumDefault assignee for new issues: 'PROJECT_LEAD' (assigns to project lead) or 'UNASSIGNED' (issues remain unassigned).
PROJECT_LEADUNASSIGNEDlead_account_idstringObligatorioAtlassian Account ID (not username or email) of the project lead.
project_type_keystringObligatorioenumType of project: 'business' for Jira Core type projects or 'software' for Jira Software type projects.
businesssoftwarepermission_schemeintegerOptional ID of an existing permission scheme.
notification_schemeintegerOptional ID of an existing notification scheme.
project_template_keystringObligatorioKey of the project template, compatible with 'project_type_key'. Consult Jira documentation for available template keys for the chosen project type and Jira version.
issue_security_schemeintegerOptional ID of an existing issue security scheme.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create SprintJIRA_CREATE_SPRINTAcciónCreates a new sprint on a jira board with optional start/end dates and goal.
JIRA_CREATE_SPRINTAcciónCreates a new sprint on a jira board with optional start/end dates and goal.
Parámetros de entrada
goalstringPrimary objective or goal for the sprint.
namestringObligatorioName for the new sprint.
end_datestringIntended end date and time for the sprint (ISO 8601 format).
start_datestringIntended start date and time for the sprint (ISO 8601 format).
origin_board_idintegerObligatorioIdentifier of the Jira board for the new sprint.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create VersionJIRA_CREATE_VERSIONAcciónCreates a new version for releases or milestones in a jira project.
JIRA_CREATE_VERSIONAcciónCreates a new version for releases or milestones in a jira project.
Parámetros de entrada
namestringObligatorioName for the new version. It is recommended that version names be unique within a project.
archivedbooleanIndicates if the version is marked as archived.
releasedbooleanIndicates if the version is marked as released.
projectIdintegerObligatorioNumeric ID of the Jira project to which this version will be added. The project must exist.
startDatestringStart date for work on the version (YYYY-MM-DD format).
descriptionstringTextual description for the version, providing more context about its purpose or content.
releaseDatestringRelease date for the version (YYYY-MM-DD format). Relevant if the version is marked as released or has a planned release.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete CommentJIRA_DELETE_COMMENTAcciónDeletes a specific comment from a jira issue using its id and the issue's id/key; requires user permission to delete comments on the issue.
JIRA_DELETE_COMMENTAcciónDeletes a specific comment from a jira issue using its id and the issue's id/key; requires user permission to delete comments on the issue.
Parámetros de entrada
idstringObligatorioThe unique identifier of the comment to be deleted (e.g., '10001').
issueIdOrKeystringObligatorioThe ID (e.g., '10000') or key (e.g., 'PROJ-123') of the Jira issue from which the comment will be deleted.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete IssueJIRA_DELETE_ISSUEAcciónDeletes a jira issue by its id or key.
JIRA_DELETE_ISSUEAcciónDeletes a jira issue by its id or key.
Parámetros de entrada
delete_subtasksbooleanIf true, the issue's subtasks are also deleted. If false and the issue has subtasks, the deletion will fail.
issue_id_or_keystringObligatorioThe ID or key of the issue to delete.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete VersionJIRA_DELETE_VERSIONAcciónDeletes a jira version and optionally reassigns its issues.
JIRA_DELETE_VERSIONAcciónDeletes a jira version and optionally reassigns its issues.
Parámetros de entrada
version_idstringObligatorioThe unique identifier of the version to be deleted.
move_fix_issues_tostringThe ID of an alternative version to which issues with the deleted version as their fix version will be moved. If unspecified or null, these issues will remain unassigned from a fix version.
move_affected_issues_tostringThe ID of an alternative version to which issues with the deleted version as their affected version will be moved. If unspecified or null, these issues will remain unassigned from an affected version.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete WorklogJIRA_DELETE_WORKLOGAcciónDeletes a worklog from a jira issue with estimate adjustment options.
JIRA_DELETE_WORKLOGAcciónDeletes a worklog from a jira issue with estimate adjustment options.
Parámetros de entrada
worklog_idstringObligatorioThe ID of the specific worklog entry to be deleted from the issue.
increase_bystringAmount to increase the remaining estimate if `adjust_estimate` is 'manual' (e.g., '1h 30m', '5d').
new_estimatestringValue for the new remaining estimate if `adjust_estimate` is 'new' (e.g., '2h', '3d 4h').
notify_usersbooleanIf users watching the issue should be notified by email about the worklog deletion.
adjust_estimatestringHow to update the issue's remaining estimate: 'new' (set to `new_estimate`), 'leave' (unchanged), 'manual' (reduce by `increase_by`), or 'auto' (reduce by deleted worklog time).
issue_id_or_keystringObligatorioThe ID or key of the Jira issue from which the worklog will be deleted.
override_editable_flagbooleanIf true, allows deletion of the worklog even if the issue is in a closed status, potentially bypassing workflow restrictions.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Edit IssueJIRA_EDIT_ISSUEAcciónUpdates an existing jira issue with field values and operations. supports direct field parameters (summary, description, assignee, priority, etc.) that are merged with the fields parameter. direct parameters take precedence.
JIRA_EDIT_ISSUEAcciónUpdates an existing jira issue with field values and operations. supports direct field parameters (summary, description, assignee, priority, etc.) that are merged with the fields parameter. direct parameters take precedence.
Parámetros de entrada
fieldsobjectDictionary of fields for direct updates (e.g., summary, description). See Jira's 'edit issue metadata' for available fields. Provide complex data as a JSON string. Use `update` for more complex operations like list modifications.
labelsstring[]List of labels to set for the issue (replaces existing labels). New labels are created if they don't exist.
updateobjectDictionary for granular field operations (e.g., adding/removing labels, modifying list items). See Jira documentation for operation structure. Provide complex data as a JSON string.
summarystringBrief, descriptive title for the issue.
assigneestringUser to assign the issue to. Can be either an account ID (e.g., '5b10a2844c20165700ede21g') or name/email (e.g., 'john@company.com', 'John Doe'). The system will auto-detect the type and search accordingly. Use null to unassign.
due_datestringExpected resolution date in YYYY-MM-DD format. Use null to remove due date.
descriptionstringDetailed description of the issue. Supports Markdown formatting including **bold**, *italic*, `code`, links [text](url), and lists.
notify_usersbooleanIf true, sends notification email to watchers. Setting to `False` requires admin or project admin permissions.
return_issuebooleanIf true, response includes full updated issue details; if false, response is minimal.
issue_id_or_keystringObligatorioID or key of the Jira issue to be edited.
sprint_id_or_namestringSprint to assign this issue to. Can be either a sprint ID (e.g., '123', '456') or sprint name (e.g., 'Sprint 1', 'Release Sprint').
priority_id_or_namestringPriority level for the issue. Can be either a priority ID (e.g., '1', '2') or priority name (e.g., 'High', 'Medium', 'Low').
override_editable_flagbooleanIf true, bypasses editable flag restrictions. Requires admin permissions.
override_screen_securitybooleanIf true, bypasses screen security restrictions. Requires admin permissions.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Find UsersJIRA_FIND_USERSAcciónSearches for jira users by email, display name, or username to find account ids; essential for assigning issues, adding watchers, and other user-related operations.
JIRA_FIND_USERSAcciónSearches for jira users by email, display name, or username to find account ids; essential for assigning issues, adding watchers, and other user-related operations.
Parámetros de entrada
querystringA query string that is matched against user attributes. This can be used to search by display name, email address, or username. For example, 'john@company.com' to find a user by email.
start_atintegerThe 0-based index of the first item to return in the page of results. Used for pagination.
usernamestringThe username to search for. This parameter is deprecated in newer Jira versions but may still work in some instances.
account_idstringThe account ID to search for. Use this to get user details when you already have the account ID.
max_resultsintegerThe maximum number of items to return per page. Defaults to 50. Maximum allowed is typically 1000.
include_activebooleanWhether to include active users in the search results. Defaults to true.
include_inactivebooleanWhether to include inactive users in the search results. Defaults to false.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get All Issue Type SchemesJIRA_GET_ALL_ISSUE_TYPE_SCHEMESAcciónRetrieves all jira issue type schemes with optional filtering and pagination.
JIRA_GET_ALL_ISSUE_TYPE_SCHEMESAcciónRetrieves all jira issue type schemes with optional filtering and pagination.
Parámetros de entrada
idinteger[]The list of issue type scheme IDs to filter results. Returns only schemes with these IDs.
start_atintegerThe index of the first item to return in a page of results (page offset). Default is 0.
max_resultsintegerThe maximum number of items to return per page. Default is 50, maximum is 100.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get all projectsJIRA_GET_ALL_PROJECTSAcciónRetrieves all visible projects using the modern paginated jira api with server-side filtering and pagination support.
JIRA_GET_ALL_PROJECTSAcciónRetrieves all visible projects using the modern paginated jira api with server-side filtering and pagination support.
Parámetros de entrada
namestringDEPRECATED: Use 'query' parameter instead. The project name (or part of it) to filter the results. This will be mapped to the 'query' parameter.
querystringFilter the results using a query string. Projects with a name or key that contains the query string are returned. The search is case-insensitive.
actionstringFilter results by projects for which the user can: 'view' (default), 'browse', 'edit', or 'admin'.
expandstringA comma-separated list of entities to expand in the response for additional project details. Valid options include: `description` (to include the project description), `issueTypes` (to include all issue types associated with the project), `lead` (to include information about the project lead), and `projectKeys` (to include all project keys associated with the project).
statusstring[]EXPERIMENTAL. Filter results by project status. Valid values: 'live', 'archived', 'deleted'.
orderBystringOrder the results by a field. Valid values: 'category', 'issueCount', 'key', 'lastIssueUpdatedTime', 'name', 'owner', 'archivedDate', 'deletedDate'. Prefix with '-' for descending order.
startAtintegerThe index of the first item to return in a page of results (page offset). The base index is 0.
categoryIdintegerThe ID of the project category to filter by.
maxResultsintegerThe maximum number of projects to return per page. Maximum allowed value is 100.
propertiesstring[]A list of project property keys to include in the response for each project, allowing retrieval of custom project entity properties. For example, if a project has a property with key 'com.example.property', including this key here as part of the list will return its value. Provide as a list of strings, e.g., `['property1', 'property2']`.
Parámetros de salida
dataobjectObligatorioPaginated project search results with metadata and project list
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Issue StatusesJIRA_GET_ALL_STATUSESAcciónRetrieves all available issue statuses from jira with details.
JIRA_GET_ALL_STATUSESAcciónRetrieves all available issue statuses from jira with details.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get All UsersJIRA_GET_ALL_USERSAcciónRetrieves all users from the jira instance including active, inactive, and other user states with pagination support.
JIRA_GET_ALL_USERSAcciónRetrieves all users from the jira instance including active, inactive, and other user states with pagination support.
Parámetros de entrada
start_atintegerThe 0-based index of the first item to return in the page of results. Used for pagination to retrieve users in chunks.
max_resultsintegerThe maximum number of items to return per page. Used for pagination. The Jira instance might have a default and/or maximum limit for this value.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get CommentJIRA_GET_COMMENTAcciónRetrieves a specific comment by id from a jira issue with optional expansions.
JIRA_GET_COMMENTAcciónRetrieves a specific comment by id from a jira issue with optional expansions.
Parámetros de entrada
expandstringOptional. Sections to expand, e.g., 'renderedBody' for HTML. See Jira API docs for other values.
comment_idstringObligatorioUnique ID of the comment to retrieve.
issue_id_or_keystringObligatorioID or key of the Jira issue (e.g., '10000' or 'PROJ-123').
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Current UserJIRA_GET_CURRENT_USERAcciónRetrieves detailed information about the currently authenticated jira user.
JIRA_GET_CURRENT_USERAcciónRetrieves detailed information about the currently authenticated jira user.
Parámetros de entrada
expandstringComma-separated list of user properties to expand, e.g., 'groups', 'applicationRoles'.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get IssueJIRA_GET_ISSUEAcciónRetrieves a jira issue by id or key with customizable fields and expansions.
JIRA_GET_ISSUEAcciónRetrieves a jira issue by id or key with customizable fields and expansions.
Parámetros de entrada
expandstringA comma-separated string of issue entities to expand in the response, providing more details. Common expansions include 'renderedFields' (HTML content), 'changelog' (history), 'transitions' (available workflows), and 'operations' (available actions).
fieldsstring[]A list of field names or IDs to return for the issue. If omitted or empty, a default set of fields (often all fields or all navigable fields) is returned. For specific fields, provide a list like `["summary", "status"]`.
propertiesstring[]A list of issue property keys to include in the response. Issue properties are extra key-value data attached to an issue, often by apps. Example: `["jira.meta.data", "com.example.custom.info"]`.
fields_by_keysbooleanIf true, the strings in the `fields` parameter are interpreted as field keys (e.g., 'summary') instead of field IDs (e.g., 'customfield_10000'). Default is false (uses field IDs).
update_historybooleanIf true, viewing the issue will add it to the user's 'Recently Viewed' issues list. Set to false to prevent this, which can be useful for automated processes. The default behavior (true or false) can be determined by Jira's system settings if not explicitly set.
issue_id_or_keystringObligatorioThe ID (e.g., '10000') or key (e.g., 'PROJ-123') of the Jira issue to retrieve.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Issue Link TypesJIRA_GET_ISSUE_LINK_TYPESAcciónRetrieves all configured issue link types from jira.
JIRA_GET_ISSUE_LINK_TYPESAcciónRetrieves all configured issue link types from jira.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Issue PropertyJIRA_GET_ISSUE_PROPERTYAcciónRetrieves a custom property from a jira issue by key.
JIRA_GET_ISSUE_PROPERTYAcciónRetrieves a custom property from a jira issue by key.
Parámetros de entrada
property_keystringObligatorioThe key of the issue property to retrieve. Property keys are often dot-separated, like 'com.example.property.key'.
issue_id_or_keystringObligatorioThe ID (e.g., '10000') or key (e.g., 'TEST-123') of the Jira issue.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Issue ResolutionsJIRA_GET_ISSUE_RESOLUTIONSAcciónRetrieves all available issue resolution types from jira.
JIRA_GET_ISSUE_RESOLUTIONSAcciónRetrieves all available issue resolution types from jira.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get issue typesJIRA_GET_ISSUE_TYPESAcciónRetrieves all jira issue types available to the user using the modern api v3 endpoint; results vary based on 'administer jira' global or 'browse projects' project permissions.
JIRA_GET_ISSUE_TYPESAcciónRetrieves all jira issue types available to the user using the modern api v3 endpoint; results vary based on 'administer jira' global or 'browse projects' project permissions.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Issue Type SchemeJIRA_GET_ISSUE_TYPE_SCHEMEAcciónGets a jira issue type scheme by id with all associated issue types.
JIRA_GET_ISSUE_TYPE_SCHEMEAcciónGets a jira issue type scheme by id with all associated issue types.
Parámetros de entrada
issue_type_scheme_idstringObligatorioThe unique identifier (ID) of the Jira issue type scheme to be retrieved.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Issue WatchersJIRA_GET_ISSUE_WATCHERSAcciónRetrieves users watching a jira issue for update notifications.
JIRA_GET_ISSUE_WATCHERSAcciónRetrieves users watching a jira issue for update notifications.
Parámetros de entrada
start_atintegerThe 0-based index of the first watcher to return in the paginated list. Use for pagination.
max_resultsintegerThe maximum number of watchers to return per page. Use for pagination. Must be 1 or greater if provided.
issue_id_or_keystringObligatorioThe ID or key of the Jira issue for which to retrieve watchers. This can be the numerical ID (e.g., '10000') or the human-readable key (e.g., 'PROJ-123').
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Issue WorklogsJIRA_GET_ISSUE_WORKLOGSAcciónRetrieves worklogs for a jira issue with user permission checks.
JIRA_GET_ISSUE_WORKLOGSAcciónRetrieves worklogs for a jira issue with user permission checks.
Parámetros de entrada
start_atintegerIndex of the first worklog to return (for pagination). Defaults to 0.
max_resultsintegerMaximum number of worklogs to return per page. Defaults to a system-defined limit.
started_afterintegerFilters worklogs to include only those started after this Unix timestamp (milliseconds).
started_beforeintegerFilters worklogs to include only those started before this Unix timestamp (milliseconds).
issue_id_or_keystringObligatorioThe ID or key of the issue for which worklogs are to be fetched.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Project VersionsJIRA_GET_PROJECT_VERSIONSAcciónRetrieves all versions for a jira project with optional expansion.
JIRA_GET_PROJECT_VERSIONSAcciónRetrieves all versions for a jira project with optional expansion.
Parámetros de entrada
expandstringComma-separated string of properties to expand for each version (e.g., 'operations', 'issuesstatus').
project_id_or_keystringObligatorioThe ID or unique key of the Jira project for which versions are to be retrieved. For example, '10000' or 'PROJECTKEY'.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Issue Remote LinksJIRA_GET_REMOTE_ISSUE_LINKSAcciónRetrieves links from a jira issue to external resources.
JIRA_GET_REMOTE_ISSUE_LINKSAcciónRetrieves links from a jira issue to external resources.
Parámetros de entrada
global_idstringOptional. The global ID of a specific remote issue link to retrieve, provided by the external linking application. If specified, only the remote issue link matching this global ID is returned.
issue_id_or_keystringObligatorioThe ID (e.g., '10000') or key (e.g., 'PROJECT-123') of the Jira issue for which to retrieve remote links.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get TransitionsJIRA_GET_TRANSITIONSAcciónRetrieves available workflow transitions for a jira issue.
JIRA_GET_TRANSITIONSAcciónRetrieves available workflow transitions for a jira issue.
Parámetros de entrada
expandstringA comma-separated list of properties to expand in the response. Use 'transitions.fields' to include the fields associated with each transition, providing details on what input is expected or allowed.
transition_idstringThe ID of a specific transition to retrieve. If provided, only details for this transition are returned.
issue_id_or_keystringObligatorioThe ID (e.g., '10000') or key (e.g., 'PROJ-123') of the Jira issue for which to retrieve transitions.
skip_remote_only_conditionbooleanIf true, conditions defined by remote apps that only run remotely will be skipped during evaluation.
sort_by_ops_bar_and_statusbooleanIf true, sorts the returned transitions by their order in the operations bar and then by status category.
include_unavailable_transitionsbooleanIf true, transitions that are not currently available for the issue (e.g., due to unmet conditions) will be included in the response.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Issue VotesJIRA_GET_VOTESAcciónFetches voting details for a jira issue; requires voting to be enabled in jira's general settings.
JIRA_GET_VOTESAcciónFetches voting details for a jira issue; requires voting to be enabled in jira's general settings.
Parámetros de entrada
issue_id_or_keystringObligatorioThe ID or key of the Jira issue (e.g., 'PROJ-123' or '10000').
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get WorklogsJIRA_GET_WORKLOGAcciónRetrieves worklogs for a specified jira issue.
JIRA_GET_WORKLOGAcciónRetrieves worklogs for a specified jira issue.
Parámetros de entrada
expandstringA comma-separated list of worklog properties to expand in the response. For instance, 'properties' can be used to include custom fields associated with the worklogs. Refer to the Jira API documentation for other possible values.
start_atintegerThe 0-based index of the first worklog to return. Used for pagination to retrieve results beyond the initial page. For example, if `maxResults` is 50, `startAt=50` retrieves the second page.
max_resultsintegerThe maximum number of worklogs to return per page. Used for pagination. If not specified, a Jira-defined default is used (e.g., 50).
started_afterintegerFilters worklogs to include only those started on or after this specified date and time. Provide as a Unix timestamp in milliseconds (milliseconds since January 1, 1970, 00:00:00 UTC).
started_beforeintegerFilters worklogs to include only those started on or before this specified date and time. Provide as a Unix timestamp in milliseconds (milliseconds since January 1, 1970, 00:00:00 UTC).
issue_id_or_keystringObligatorioThe ID (e.g., '10001') or key (e.g., 'PROJECT-123') of the Jira issue for which to retrieve worklogs.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List BoardsJIRA_LIST_BOARDSAcciónRetrieves paginated jira boards with filtering and sorting options.
JIRA_LIST_BOARDSAcciónRetrieves paginated jira boards with filtering and sorting options.
Parámetros de entrada
namestringFilters results to boards whose name contains the string (case-insensitive).
typestringenumFilters results to boards of the specified type.
scrumkanbanorderBystringField to order boards by (e.g., 'name', '-name' for descending). Refer to Jira API docs for all sortable fields.
start_atintegerIndex of the first board to return (0-based) for pagination.
max_resultsintegerMaximum number of boards to return per page.
includePrivatebooleanInclude private boards in the results.
projectKeyOrIdstringFilters results to boards for the specified project, by its key (e.g., 'PROJECTKEY') or ID (e.g., '10000').
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Issue CommentsJIRA_LIST_ISSUE_COMMENTSAcciónRetrieves paginated comments from a jira issue with optional ordering.
JIRA_LIST_ISSUE_COMMENTSAcciónRetrieves paginated comments from a jira issue with optional ordering.
Parámetros de entrada
expandstringUse 'renderedBody' to include the HTML-rendered version of the comment body in the response.
order_bystringSpecifies the field to sort comments by; use 'created' for ascending by creation date (currently the only supported value).
start_atintegerThe 0-based index of the first comment to return.
max_resultsintegerThe maximum number of comments to return per page.
issue_id_or_keystringObligatorioThe ID (e.g., '10000') or key (e.g., 'PROJ-123') of the Jira issue from which to retrieve comments.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List SprintsJIRA_LIST_SPRINTSAcciónRetrieves paginated sprints from a jira board with optional state filtering.
JIRA_LIST_SPRINTSAcciónRetrieves paginated sprints from a jira board with optional state filtering.
Parámetros de entrada
statestringFilters sprints by state: 'future', 'active', or 'closed'. Returns all states if omitted.
board_idintegerObligatorioUnique identifier of the Jira board.
start_atinteger0-based starting index for pagination.
max_resultsintegerMaximum number of sprints per page.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Move Issues to SprintJIRA_MOVE_ISSUE_TO_SPRINTAcciónMoves one or more jira issues to a specified active sprint.
JIRA_MOVE_ISSUE_TO_SPRINTAcciónMoves one or more jira issues to a specified active sprint.
Parámetros de entrada
issuesstring[]ObligatorioA list of issue keys (e.g., 'PROJ-123') to be moved to the specified sprint.
sprint_idintegerObligatorioUnique identifier for the target sprint.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Remove Watcher from IssueJIRA_REMOVE_WATCHER_FROM_ISSUEAcciónRemoves a user from an issue's watcher list by account id.
JIRA_REMOVE_WATCHER_FROM_ISSUEAcciónRemoves a user from an issue's watcher list by account id.
Parámetros de entrada
account_idstringObligatorioThe account ID of the user to remove from the issue's watchers list.
issue_id_or_keystringObligatorioThe ID or key of the issue.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Search Issues Using JQL (GET)JIRA_SEARCH_FOR_ISSUES_USING_JQL_GETAcciónSearches for jira issues using jql with pagination and field selection.
JIRA_SEARCH_FOR_ISSUES_USING_JQL_GETAcciónSearches for jira issues using jql with pagination and field selection.
Parámetros de entrada
jqlstringObligatorioJira Query Language (JQL) string for searching issues.
expandstringComma-separated list of entities to expand within issues (e.g., `renderedFields`, `changelog`).
fieldsstring[]Specific issue fields to retrieve (e.g., `summary`, `customfield_10010`, `*all`, `*navigable`). Defaults if omitted.
start_atinteger0-based index for the first issue in pagination.
propertiesstring[]List of issue property keys (key-value metadata) to retrieve.
max_resultsintegerMaximum issues to retrieve per page; Jira API may enforce limits.
fields_by_keysbooleanSet to `True` to identify fields by keys (e.g., 'customfield_10000') instead of IDs.
validate_querystringControls JQL query validation: `strict` (fails on invalid JQL), `warn` (warnings, empty result), `none` (no validation). `true` is an alias for `strict`, `false` for `none`.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Search Issues Using JQL (POST)JIRA_SEARCH_FOR_ISSUES_USING_JQL_POSTAcciónSearches for jira issues using jql via post request for complex queries; ideal for lengthy jql queries that might exceed url character limits
JIRA_SEARCH_FOR_ISSUES_USING_JQL_POSTAcciónSearches for jira issues using jql via post request for complex queries; ideal for lengthy jql queries that might exceed url character limits
Parámetros de entrada
jqlstringObligatorioThe JQL (Jira Query Language) query string to use for the search. For example, 'project = HSP AND issuetype = Bug'.
expandstringA comma-separated list of entities to expand in the response. Options include: 'renderedFields' (HTML values), 'names' (display name of fields), 'schema' (field type schema), 'transitions' (possible issue transitions), 'operations' (possible issue operations), 'editmeta' (field editability info), 'changelog' (recent updates), 'versionedRepresentations' (field version history).
fieldsstring[]A list of fields to return for each issue. By default, all fields are returned. Specify 'none' to return no fields. Examples: 'summary', 'status', 'assignee'. Use '*navigable' to return all navigable fields.
start_atintegerThe 0-based index of the first issue to return from the query results. Used for pagination.
propertiesstring[]A list of issue property keys to return for each issue. Issue properties are key-value pairs on the issue that can be set and read by apps (e.g., 'jira.issue.tools', 'com.example.application:properties').
max_resultsintegerThe maximum number of issues to return per page. Used for pagination.
fields_by_keysbooleanIf true, returns field values referenced by their keys (e.g., 'customfield_10000') instead of their IDs.
validate_querystringControls how the JQL query is validated. 'strict' throws an error for invalid JQL. 'warn' returns a warning for invalid JQL but still executes the query if possible. 'none' performs no JQL validation.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Search issuesJIRA_SEARCH_ISSUESAcciónAdvanced jira issue search supporting structured filters and raw jql.
JIRA_SEARCH_ISSUESAcciónAdvanced jira issue search supporting structured filters and raw jql.
Parámetros de entrada
jqlstringRaw JQL query for advanced users. Takes precedence over filters.
labelsstring[]Filter by labels (all labels must match).
assigneestringFilter by assignee. Can be account ID (e.g., '712020:abc...'), email (e.g., 'john@company.com'), display name (e.g., 'John Doe'), or 'unassigned'.
start_atinteger0-based index of the first issue to return (for pagination).
max_resultsintegerMaximum number of issues to return.
project_keystringFilter by project key (e.g., 'PROJ').
text_searchstringSearch in summary and description text.
created_afterstringFilter issues created after this date. Supports YYYY-MM-DD format or relative dates like '-30m' (last 30 minutes), '-7d' (last 7 days), '-1w' (last week), '-1M' (last month).
updated_afterstringFilter issues updated after this date. Supports YYYY-MM-DD format or relative dates like '-30m' (last 30 minutes), '-7d' (last 7 days), '-1w' (last week), '-1M' (last month).
created_beforestringFilter issues created before this date (YYYY-MM-DD format).
updated_beforestringFilter issues updated before this date (YYYY-MM-DD format).
sprint_id_or_namestringFilter by sprint. Can be sprint ID (e.g., '123') or name (e.g., 'Sprint 1', 'Release Sprint').
status_id_or_namestringFilter by status. Can be either a status ID (e.g., '10001') or name (e.g., 'To Do', 'In Progress', 'Done').
priority_id_or_namestringFilter by priority. Can be either a priority ID (e.g., '1', '2') or name (e.g., 'High', 'Medium', 'Low').
issue_type_id_or_namestringFilter by issue type. Can be either an issue type ID (e.g., '10001') or name (e.g., 'Bug', 'Task', 'Story').
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Send Notification for IssueJIRA_SEND_NOTIFICATION_FOR_ISSUEAcciónSends a customized email notification for a jira issue.
JIRA_SEND_NOTIFICATION_FOR_ISSUEAcciónSends a customized email notification for a jira issue.
Parámetros de entrada
toobjectObligatorioA `NotificationRecipients` object specifying who should receive the notification. At least one recipient category (e.g., reporter, assignee, a user, or a group) within this object must be configured.
subjectstringObligatorioThe subject line for the email notification.
restrictobjectOptional restrictions defining who can receive the notification. If specified, notifications are sent only to users who meet the criteria in `groups` (if provided) AND `permissions` (if provided), AND also have general permission to view the issue.
html_bodystringThe HTML content of the email notification. This field is optional unless `restrict` is used, in which case it becomes mandatory. It is recommended to also provide `text_body` for email clients that do not support HTML.
text_bodystringObligatorioThe plain text content of the email notification. This field is always mandatory.
issue_id_or_keystringObligatorioThe ID (e.g., '10000') or key (e.g., 'PROJ-123') of the Jira issue for which the notification will be sent.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Transition IssueJIRA_TRANSITION_ISSUEAcciónTransitions a jira issue to a different workflow state, with support for transition name lookup and user assignment by email.
JIRA_TRANSITION_ISSUEAcciónTransitions a jira issue to a different workflow state, with support for transition name lookup and user assignment by email.
Parámetros de entrada
commentstringOptional comment to add during the transition. Supports Markdown formatting including **bold**, *italic*, `code`, links [text](url), and lists.
assigneestringAccount ID of the user to assign the issue to during transition. Takes precedence over assignee_name.
resolutionstringOptional resolution to set (e.g., 'Done', 'Fixed', 'Won't Do').
assignee_namestringName of the user to assign the issue to during transition. Can be either an email address (e.g., 'john@company.com') or display name (e.g., 'John Doe'). The system will auto-detect the type and search accordingly. Ignored if assignee (account ID) is provided.
issue_id_or_keystringObligatorioThe ID or key of the issue to transition.
transition_id_or_namestringObligatorioThe ID or name of the transition to apply.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update CommentJIRA_UPDATE_COMMENTAcciónUpdates text content or visibility of an existing jira comment.
JIRA_UPDATE_COMMENTAcciónUpdates text content or visibility of an existing jira comment.
Parámetros de entrada
comment_idstringObligatorioThe unique ID of the comment to be updated.
comment_textstringObligatorioThe new text content for the comment. This will replace the existing comment body. Supports plain text and basic formatting like *bold*, _italic_, and @mentions.
notify_usersbooleanA boolean flag indicating whether to send notifications to users about the comment update. Defaults to True.
issue_id_or_keystringObligatorioThe ID or key of the Jira issue where the comment is located. This can be the numerical ID or the project key followed by the issue number (e.g., 'PROJ-123').
visibility_typestringOptional. The type of visibility restriction to apply to the comment. If provided, `visibility_value` must also be specified. Valid values are 'group' or 'role'.
visibility_valuestringOptional. The name of the group or role to restrict comment visibility to. Required if `visibility_type` is specified. For 'group' type, provide the group name (e.g., 'jira-administrators'). For 'role' type, provide the project role name (e.g., 'Administrators').
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Triggers (3)
Los triggers son eventos externos que pueden iniciar un flujo en tus agentes (ej: nuevo email, mensaje recibido, registro creado).
New IssueJIRA_NEW_ISSUE_TRIGGERTriggerTriggered when a new issue is created in Jira
JIRA_NEW_ISSUE_TRIGGERTriggerTriggered when a new issue is created in Jira
Configuración
project_keystringObligatorioThe Jira project key to monitor
Payload del evento
assigneestringUsername of the assignee
created_atstringObligatorioTimestamp when the issue was created
descriptionstringDescription of the issue
issue_idstringObligatorioThe ID of the created issue
issue_keystringObligatorioThe key of the created issue
project_keystringObligatorioThe project key
reporterstringObligatorioUsername of the reporter
summarystringObligatorioSummary of the issue
New ProjectJIRA_NEW_PROJECT_TRIGGERTriggerTriggered when a new project is added in Jira
JIRA_NEW_PROJECT_TRIGGERTriggerTriggered when a new project is added in Jira
Configuración
Sin parámetros.
Payload del evento
created_atstringObligatorioTimestamp when the project was created
lead_namestringObligatorioThe username of the project lead
project_idstringObligatorioThe ID of the created project
project_keystringObligatorioThe key of the created project
project_namestringObligatorioThe name of the created project
project_typestringObligatorioThe type of the created project
Updated IssueJIRA_UPDATED_ISSUE_TRIGGERTriggerTriggered when an issue is updated in Jira
JIRA_UPDATED_ISSUE_TRIGGERTriggerTriggered when an issue is updated in Jira
Configuración
project_keystringObligatorioThe Jira project key to monitor
Payload del evento
assigneestringUsername of the assignee
descriptionstringDescription of the issue
issue_idstringObligatorioThe ID of the updated issue
issue_keystringObligatorioThe key of the updated issue
project_keystringObligatorioThe project key
reporterstringObligatorioUsername of the reporter
summarystringObligatorioSummary of the issue
updated_atstringObligatorioTimestamp when the issue was updated
updated_fieldsobjectObligatorioFields that were updated