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
bearer_token
string
subdomain
stringRequired
basic_encoded
stringRequired

Tools

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

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_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_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_EDIT_ISSUE

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
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_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_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_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_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