Productivity

Jira

Learn how to use Jira with Composio

Overview

SLUG

JIRA

Description

A tool for bug tracking, issue tracking, and agile project management.

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,read:sprint:jira-software,write:sprint:jira-software,read:board-scope:jira-software,write:board-scope:jira-software,read:project:jira
bearer_token
string
subdomain
stringRequired
basic_encoded
stringRequired

Tools

SLUG: JIRA_ADD_COMMENT

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_ADD_WATCHER_TO_ISSUE

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_ASSIGN_ISSUE

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_BULK_CREATE_ISSUE

Creates multiple jira issues (up to 50 per call) with required project and issue type.

Action Parameters

issueUpdates
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_CREATE_ISSUE

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
sprint_id
integer
summary
stringRequired
versions
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_EDIT_ISSUE

Updates 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.

Action Parameters

assignee
string
description
string
due_date
string
fields
object
issue_id_or_key
stringRequired
labels
array
notify_users
booleanDefaults to True
override_editable_flag
boolean
override_screen_security
boolean
priority_id_or_name
string
return_issue
boolean
sprint_id_or_name
string
summary
string
update
object

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_FIND_USERS

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_GET_ALL_PROJECTS

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_GET_CURRENT_USER

Retrieves detailed information about the currently authenticated jira user.

Action Parameters

expand
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_GET_ISSUE

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_GET_ISSUE_RESOLUTIONS

Retrieves all available issue resolution types from jira.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_GET_ISSUE_STATUSES

Retrieves all available issue statuses from jira with details.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_GET_ISSUE_TYPES

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_GET_TRANSITIONS

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_LIST_BOARDS

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_LIST_ISSUE_COMMENTS

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_LIST_SPRINTS

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_MOVE_ISSUE_TO_SPRINT

Moves one or more jira issues to a specified active sprint.

Action Parameters

issues
arrayRequired
sprint_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_SEARCH_FOR_ISSUES_USING_JQL_GET

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_SEARCH_ISSUES

Advanced jira issue search supporting structured filters and raw jql.

Action Parameters

assignee
string
created_after
string
created_before
string
issue_type_id_or_name
string
jql
string
labels
array
max_results
integerDefaults to 20
priority_id_or_name
string
project_key
string
sprint_id_or_name
string
start_at
integer
status_id_or_name
string
text_search
string
updated_after
string
updated_before
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_TRANSITION_ISSUE

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_ADD_ATTACHMENT_TO_ISSUE

Uploads and attaches a file to a jira issue.

Action Parameters

file_content
stringRequired
file_name
stringRequired
issue_key
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_CREATE_PROJECT

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_CREATE_SPRINT

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_CREATE_VERSION

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_DELETE_COMMENT

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_DELETE_ISSUE

Deletes a jira issue by its id or key.

Action Parameters

delete_subtasks
boolean
issue_id_or_key
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_DELETE_VERSION

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_DELETE_WORKLOG

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_GET_ALL_USERS

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_GET_COMMENT

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_GET_ISSUE_PROPERTY

Retrieves a custom property from a jira issue by key.

Action Parameters

issue_id_or_key
stringRequired
property_key
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_GET_ISSUE_TYPE_SCHEME

Gets a jira issue type scheme by id with all associated issue types.

Action Parameters

issue_type_scheme_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_GET_ISSUE_VOTES

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_GET_ISSUE_WATCHERS

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_GET_ISSUE_WORKLOGS

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_GET_PROJECT_VERSIONS

Retrieves all versions for a jira project with optional expansion.

Action Parameters

expand
string
project_id_or_key
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_GET_WORKLOG

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_REMOVE_WATCHER_FROM_ISSUE

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_SEARCH_FOR_ISSUES_USING_JQL_POST

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_SEND_NOTIFICATION_FOR_ISSUE

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
objectRequired
error
string
successful
booleanRequired

SLUG: JIRA_UPDATE_COMMENT

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
objectRequired
error
string
successful
booleanRequired