Jira

Learn how to use Jira with Composio

Overview

Enum

JIRA

Description

Jira API tool

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
stringDefaults to read:jira-work,write:jira-work,manage:jira-project,manage:jira-configuration,read:jira-user,manage:jira-webhook,manage:jira-data-provider,read:servicedesk-request,manage:servicedesk-customer,write:servicedesk-request,read:servicemanagement-insight-objects,offline_access
Base64_Encode
stringRequired
your-domain
stringRequired

Actions

Uploads and attaches a file to a jira issue.

Action Parameters

file_content
stringRequired
file_name
stringRequired
issue_key
stringRequired

Action Response

data
object
error
successful
boolean
Adds a comment using atlassian document format (adf) for rich text to an existing jira issue.

Action Parameters

comment
stringRequired
issue_id_or_key
stringRequired
visibility_type
string
visibility_value
string

Action Response

data
object
error
successful
boolean
Adds a user to an issue's watcher list by account id.

Action Parameters

account_id
stringRequired
issue_id_or_key
stringRequired

Action Response

data
object
error
successful
boolean
Assigns a jira issue to a user, default assignee, or unassigns; supports email/name lookup.

Action Parameters

account_id
string
assignee_name
string
issue_id_or_key
stringRequired

Action Response

data
object
error
successful
boolean
Creates multiple jira issues (up to 50 per call) with required project and issue type.

Action Parameters

issueUpdates
arrayRequired

Action Response

data
object
error
successful
boolean
Creates a new jira issue (e.g., bug, task, story) in a specified project.

Action Parameters

assignee
string
assignee_name
string
components
array
description
string
due_date
string
environment
string
fix_versions
array
issue_type
stringDefaults to Task
labels
array
priority
string
project_key
stringRequired
reporter
string
summary
stringRequired
versions
array

Action Response

data
object
error
successful
boolean
Creates a new jira project with required lead, template, and type configuration.

Action Parameters

assignee_type
string
avatar_id
integer
category_id
integer
description
string
issue_security_scheme
integer
key
stringRequired
lead_account_id
stringRequired
name
stringRequired
notification_scheme
integer
permission_scheme
integer
project_template_key
stringRequired
project_type_key
stringRequired
url
string

Action Response

data
object
error
successful
boolean
Creates a new sprint on a jira board with optional start/end dates and goal.

Action Parameters

end_date
string
goal
string
name
stringRequired
origin_board_id
integerRequired
start_date
string

Action Response

data
object
error
successful
boolean
Creates a new version for releases or milestones in a jira project.

Action Parameters

archived
boolean
description
string
name
stringRequired
projectId
integerRequired
releaseDate
string
released
boolean
startDate
string

Action Response

data
object
error
successful
boolean
Deletes 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.

Action Parameters

id
stringRequired
issueIdOrKey
stringRequired

Action Response

data
object
error
successful
boolean
Deletes a jira issue by its id or key.

Action Parameters

delete_subtasks
boolean
issue_id_or_key
stringRequired

Action Response

data
object
error
successful
boolean
Deletes a jira version and optionally reassigns its issues.

Action Parameters

move_affected_issues_to
string
move_fix_issues_to
string
version_id
stringRequired

Action Response

data
object
error
successful
boolean
Deletes a worklog from a jira issue with estimate adjustment options.

Action Parameters

adjust_estimate
stringDefaults to auto
increase_by
string
issue_id_or_key
stringRequired
new_estimate
string
notify_users
booleanDefaults to True
override_editable_flag
boolean
worklog_id
stringRequired

Action Response

data
object
error
successful
boolean
Updates an existing jira issue with field values and operations.

Action Parameters

fields
object
issue_id_or_key
stringRequired
notify_users
booleanDefaults to True
override_editable_flag
boolean
override_screen_security
boolean
return_issue
boolean
update
object

Action Response

data
object
error
successful
boolean
Searches for jira users by email, display name, or username to find account ids; essential for assigning issues, adding watchers, and other user-related operations.

Action Parameters

account_id
string
include_active
booleanDefaults to True
include_inactive
boolean
max_results
integer
query
string
start_at
integer
username
string

Action Response

data
object
error
successful
boolean
Retrieves all visible projects using the modern paginated jira api with server-side filtering and pagination support.

Action Parameters

action
stringDefaults to view
categoryId
integer
expand
string
maxResults
integerDefaults to 50
name
string
orderBy
stringDefaults to name
properties
array
query
string
startAt
integer
status
array

Action Response

data
object
error
successful
boolean
Retrieves all users from the jira instance including active, inactive, and other user states with pagination support.

Action Parameters

max_results
integer
start_at
integer

Action Response

data
object
error
successful
boolean
Retrieves a specific comment by id from a jira issue with optional expansions.

Action Parameters

comment_id
stringRequired
expand
string
issue_id_or_key
stringRequired

Action Response

data
object
error
successful
boolean
Retrieves detailed information about the currently authenticated jira user.

Action Parameters

expand
string

Action Response

data
object
error
successful
boolean
Retrieves a jira issue by id or key with customizable fields and expansions.

Action Parameters

expand
string
fields
array
fields_by_keys
boolean
issue_id_or_key
stringRequired
properties
array
update_history
boolean

Action Response

data
object
error
successful
boolean
Retrieves a custom property from a jira issue by key.

Action Parameters

issue_id_or_key
stringRequired
property_key
stringRequired

Action Response

data
object
error
successful
boolean
Retrieves all available issue resolution types from jira.

Action Parameters

Action Response

data
object
error
successful
boolean
Retrieves all available issue statuses from jira with details.

Action Parameters

Action Response

data
object
error
successful
boolean
Retrieves 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.

Action Parameters

Action Response

data
object
error
successful
boolean
Gets a jira issue type scheme by id with all associated issue types.

Action Parameters

issue_type_scheme_id
stringRequired

Action Response

data
object
error
successful
boolean
Fetches voting details for a jira issue; requires voting to be enabled in jira's general settings.

Action Parameters

issue_id_or_key
stringRequired

Action Response

data
object
error
successful
boolean
Retrieves users watching a jira issue for update notifications.

Action Parameters

issue_id_or_key
stringRequired
max_results
integer
start_at
integer

Action Response

data
object
error
successful
boolean
Retrieves worklogs for a jira issue with user permission checks.

Action Parameters

issue_id_or_key
stringRequired
max_results
integer
start_at
integer
started_after
integer
started_before
integer

Action Response

data
object
error
successful
boolean
Retrieves all versions for a jira project with optional expansion.

Action Parameters

expand
string
project_id_or_key
stringRequired

Action Response

data
object
error
successful
boolean
Retrieves available workflow transitions for a jira issue.

Action Parameters

expand
string
include_unavailable_transitions
boolean
issue_id_or_key
stringRequired
skip_remote_only_condition
boolean
sort_by_ops_bar_and_status
boolean
transition_id
string

Action Response

data
object
error
successful
boolean
Retrieves worklogs for a specified jira issue.

Action Parameters

expand
string
issue_id_or_key
stringRequired
max_results
integer
start_at
integer
started_after
integer
started_before
integer

Action Response

data
object
error
successful
boolean
Retrieves paginated jira boards with filtering and sorting options.

Action Parameters

includePrivate
boolean
max_results
integer
name
string
orderBy
string
projectKeyOrId
string
start_at
integer
type
string

Action Response

data
object
error
successful
boolean
Retrieves paginated comments from a jira issue with optional ordering.

Action Parameters

expand
string
issue_id_or_key
stringRequired
max_results
integerDefaults to 50
order_by
string
start_at
integer

Action Response

data
object
error
successful
boolean
Retrieves paginated sprints from a jira board with optional state filtering.

Action Parameters

board_id
integerRequired
max_results
integerDefaults to 50
start_at
integer
state
string

Action Response

data
object
error
successful
boolean
Moves one or more jira issues to a specified active sprint.

Action Parameters

issues
arrayRequired
sprint_id
integerRequired

Action Response

data
object
error
successful
boolean
Converts natural language queries to jql (jira query language) using ai.

Action Parameters

context
string
query
stringRequired

Action Response

data
object
error
successful
boolean
Removes a user from an issue's watcher list by account id.

Action Parameters

account_id
stringRequired
issue_id_or_key
stringRequired

Action Response

data
object
error
successful
boolean
Searches for jira issues using jql with pagination and field selection.

Action Parameters

expand
string
fields
array
fields_by_keys
boolean
jql
stringRequired
max_results
integerDefaults to 50
properties
array
start_at
integer
validate_query
stringDefaults to strict

Action Response

data
object
error
successful
boolean
Searches for jira issues using jql via post request for complex queries; ideal for lengthy jql queries that might exceed url character limits

Action Parameters

expand
string
fields
array
fields_by_keys
boolean
jql
stringRequired
max_results
integerDefaults to 50
properties
array
start_at
integer
validate_query
stringDefaults to strict

Action Response

data
object
error
successful
boolean
Advanced jira issue search supporting natural language queries, structured filters, and raw jql.

Action Parameters

assignee_email
string
created_after
string
created_before
string
issue_type
string
jql
string
labels
array
max_results
integerDefaults to 10
natural_language_query
string
priority
string
project_key
string
start_at
integer
status
string
text_search
string
updated_after
string

Action Response

data
object
error
successful
boolean
Sends a customized email notification for a jira issue.

Action Parameters

html_body
string
issue_id_or_key
stringRequired
restrict
object
subject
stringRequired
text_body
stringRequired
to
objectRequired

Action Response

data
object
error
successful
boolean
Transitions a jira issue to a different workflow state, with support for transition name lookup and user assignment by email.

Action Parameters

assignee
string
assignee_name
string
comment
string
issue_id_or_key
stringRequired
resolution
string
transition_id_or_name
stringRequired

Action Response

data
object
error
successful
boolean
Updates text content or visibility of an existing jira comment.

Action Parameters

comment_id
stringRequired
comment_text
stringRequired
issue_id_or_key
stringRequired
notify_users
booleanDefaults to True
visibility_type
string
visibility_value
string

Action Response

data
object
error
successful
boolean