--- schema_version: "1" id: e374ee20a30a2f430c3b48f2612ed32f061c31b240b7b2ce0a1d3a12bd9ad8e8 title: Jira Connector 1.2 Reference collection: mulesoft version: current locale: en-us portal_url: https://docs.salesforce.com/mulesoft/current/en-us/jira-connector/latest/jira-connector-reference.md canonical_url: https://docs.mulesoft.com/jira-connector/latest/jira-connector-reference source_site: docs.mulesoft.com content_type: documentation content_hash: 1bf6588785653f9aedc060c3aaaa6da9ef99a98a73b50c7d0ca03bea8520fd76 description: MuleSoft Documentation Site release: "1.2" latest: true --- # Jira Connector 1.2 Reference

This topic is large and might take longer than usual to load in your browser. Allow extra time for the content to render or switch to another browser.

Anypoint Connector for Jira (Jira Connector) enables you to interface with the Jira platform without having to interact with the Jira API directly. ## [](#Config)Configurations ### [](#parameters)Parameters

Name	Type	Description	Default Value	Required
Name	String	The name for this configuration. Connectors reference the configuration with this name.		x
Connection	Basic Auth Connection Provider Oauth2 Connection Provider	The connection types that can be provided to this configuration.		x
Response Timeout	Number	Timeout for the request to the remote service.	1
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.	MINUTES
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.	AUTO
Name	String	The identifier of this element and used in other components to reference it.		x
Expiration Policy	Expiration Policy	Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. This does not mean that the instance expires at the exact moment that it becomes eligible. Mule purges the instances as appropriate.

Name

Type

Description

Default Value

Required

Name

String

The name for this configuration. Connectors reference the configuration with this name.

Connection

Basic Auth Connection Provider
Oauth2 Connection Provider

The connection types that can be provided to this configuration.

Response Timeout

Number

Timeout for the request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

MINUTES

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

AUTO

Name

String

The identifier of this element and used in other components to reference it.

Expiration Policy

Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. This does not mean that the instance expires at the exact moment that it becomes eligible. Mule purges the instances as appropriate.

## [](#connection-types)Connection Types

Jira Connector does not support authentication via personal access tokens (PATs).

### [](#Config_BasicAuth)Basic Auth Connection Provider

Name	Type	Description	Default Value
Default Headers	Array of Default Header
Query Parameters	Array of Default Query Param
Connection Timeout	Number	Timeout for establishing connections to the remote service.	30
Connection Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Connection Timeout.	SECONDS
Use Persistent Connections	Boolean	If false, each connection is closed after the first request is completed.	true
Max Connections	Number	Maximum number of outbound connections to keep open at the same time.	-1
Connection Idle Timeout	Number	Timeout for how long a connection can remain idle before it is closed.	30
Connection Idle Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Connection Idle Timeout.	SECONDS
Proxy Config	Proxy	Reusable configuration element for outbound connections through a proxy.
Stream Response	Boolean	Whether or not to stream received responses.	false
Response Buffer Size	Number	The space in bytes for the buffer where the HTTP response will be stored.	-1
Username	String	The username used to authenticate the requests.
API Token	String	API token used to authenticate the requests.
Base Uri	String	Base URI for the parameter. Each instance or tenant gets its own base URI.
Protocol	Enumeration, one of: HTTP HTTPS	Protocol to use for communication. Valid values are HTTP and HTTPS.	HTTP
TLS Configuration	Tls
Reconnection	Reconnection	When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

Name

Type

Description

Default Value

Required

Default Headers

Array of Default Header

Query Parameters

Array of Default Query Param

Connection Timeout

Number

Timeout for establishing connections to the remote service.

Connection Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Connection Timeout.

SECONDS

Use Persistent Connections

Boolean

If false, each connection is closed after the first request is completed.

true

Max Connections

Number

Maximum number of outbound connections to keep open at the same time.

-1

Connection Idle Timeout

Number

Timeout for how long a connection can remain idle before it is closed.

Connection Idle Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Connection Idle Timeout.

SECONDS

Proxy Config

Proxy

Reusable configuration element for outbound connections through a proxy.

Stream Response

Boolean

Whether or not to stream received responses.

false

Response Buffer Size

Number

The space in bytes for the buffer where the HTTP response will be stored.

-1

Username

String

The username used to authenticate the requests.

API Token

String

API token used to authenticate the requests.

Base Uri

String

Base URI for the parameter. Each instance or tenant gets its own base URI.

Protocol

Enumeration, one of:

HTTP
HTTPS

Protocol to use for communication. Valid values are HTTP and HTTPS.

HTTP

TLS Configuration

Tls

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

### [](#Config_Oauth2)Oauth2 Connection Provider Use OAuth 2.0 to delegate user authentication to the service hosting the user account. For more information, refer to [Configuring OAuth 2.0 for Connectors](https://docs.mulesoft.com/connectors/introduction/intro-config-oauth2), [Configuring OAuth 2.0 for Connectors on CloudHub](https://docs.mulesoft.com/connectors/introduction/intro-config-oauth2-cloudhub), or [OAuth Support in the SDK](https://docs.mulesoft.com/mule-sdk/latest/oauth).

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Default Headers	Array of Default Header
Query Parameters	Array of Default Query Param
Connection Timeout	Number	Timeout for establishing connections to the remote service.	30
Connection Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Connection Timeout.	SECONDS
Use Persistent Connections	Boolean	If false, each connection is closed after the first request is completed.	true
Max Connections	Number	Maximum number of outbound connections that will be kept open concurrently.	-1
Connection Idle Timeout	Number	Timeout for how long a connection can remain idle before it is closed.	30
Connection Idle Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	A time unit which qualifies the connection Idle Timeout	SECONDS
Proxy Config	Proxy	Reusable configuration element for outbound connections through a proxy
Stream Response	Boolean	Whether or not received responses should be streamed	false
Response Buffer Size	Number	The space in bytes for the buffer where the HTTP response will be stored.	-1
Base Uri	String	Parameter base URI, each instance/tenant gets its own	`https://api.atlassian.com/ex/jira`
Audience	String	Base url of the Atlassian API	api.atlassian.com
Prompt	String	Set to consent so that the screen prompting the user to grant access will display.	consent
State	String	Set this to a value that is associated with the user you are directing to the authorization URL, for example, a hash of the user’s session ID.
Domain URL	String	Instance of JIRA to retrieve the cloud ID. In order to make a request, the domain URL must be specified only when the base URI is the default.
Protocol	Enumeration, one of: HTTP HTTPS	Protocol to use for communication. Valid values are HTTP and HTTPS	HTTP
TLS Configuration	Tls
Reconnection	Reconnection	When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.
Consumer Key	String	OAuth consumer key as registered with the service provider.		x
Consumer Secret	String	OAuth consumer secret as registered with the service provider.		x
Authorization Url	String	Service provider’s authorization endpoint URL.	https://auth.atlassian.com/authorize
Access Token Url	String	The service provider’s accessToken endpoint URL	`https://auth.atlassian.com/oauth/token`
Scopes	String	OAuth scopes to request during the dance. If not provided, it will default to those in the annotation.	* read:jira-user * read:jira-work * write:jira-work * manage:jira-project * manage:jira-configuration offline_access
Resource Owner Id	String	The resource owner ID each component should use if the resource owner ID is not otherwise referenced.
Before	String	Name of a flow to execute immediately before starting the OAuth dance.
After	String	Name of a flow to execute immediately after an access token is received.
Listener Config	String	A reference to a <http:listener-config /> to use to create the listener that will receive the access token callback endpoint.		x
Callback Path	String	Path of the access token callback endpoint.		x
Authorize Path	String	Path of the local HTTP endpoint that triggers the OAuth dance.		x
External Callback Url	String	If the callback endpoint is behind a proxy or should be accessed through a non direct URL, use this parameter to tell the OAuth provider the URL to use to access the callback.
Object Store	String	A reference to the object store to use to store each resource owner ID’s data. If this value is not specified, Mule automatically provisions the default object store.

Default Headers

Array of Default Header

Query Parameters

Array of Default Query Param

Connection Timeout

Number

Timeout for establishing connections to the remote service.

Connection Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Connection Timeout.

SECONDS

Use Persistent Connections

Boolean

If false, each connection is closed after the first request is completed.

true

Max Connections

Number

Maximum number of outbound connections that will be kept open concurrently.

-1

Connection Idle Timeout

Number

Timeout for how long a connection can remain idle before it is closed.

Connection Idle Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

A time unit which qualifies the connection Idle Timeout

SECONDS

Proxy Config

Proxy

Reusable configuration element for outbound connections through a proxy

Stream Response

Boolean

Whether or not received responses should be streamed

false

Response Buffer Size

Number

The space in bytes for the buffer where the HTTP response will be stored.

-1

Base Uri

String

Parameter base URI, each instance/tenant gets its own

https://api.atlassian.com/ex/jira

Audience

String

Base url of the Atlassian API

api.atlassian.com

Prompt

String

Set to consent so that the screen prompting the user to grant access will display.

consent

State

String

Set this to a value that is associated with the user you are directing to the authorization URL, for example, a hash of the user’s session ID.

Domain URL

String

Instance of JIRA to retrieve the cloud ID. In order to make a request, the domain URL must be specified only when the base URI is the default.

Protocol

Enumeration, one of:

HTTP
HTTPS

Protocol to use for communication. Valid values are HTTP and HTTPS

HTTP

TLS Configuration

Tls

Reconnection

Consumer Key

String

OAuth consumer key as registered with the service provider.

Consumer Secret

String

OAuth consumer secret as registered with the service provider.

Authorization Url

String

Service provider’s authorization endpoint URL.

https://auth.atlassian.com/authorize

Access Token Url

String

The service provider’s accessToken endpoint URL

https://auth.atlassian.com/oauth/token

Scopes

String

OAuth scopes to request during the dance. If not provided, it will default to those in the annotation.

* read:jira-user * read:jira-work * write:jira-work * manage:jira-project * manage:jira-configuration offline_access

Resource Owner Id

String

The resource owner ID each component should use if the resource owner ID is not otherwise referenced.

Before

String

Name of a flow to execute immediately before starting the OAuth dance.

After

String

Name of a flow to execute immediately after an access token is received.

Listener Config

String

A reference to a <http:listener-config /> to use to create the listener that will receive the access token callback endpoint.

Callback Path

String

Path of the access token callback endpoint.

Authorize Path

String

Path of the local HTTP endpoint that triggers the OAuth dance.

External Callback Url

String

If the callback endpoint is behind a proxy or should be accessed through a non direct URL, use this parameter to tell the OAuth provider the URL to use to access the callback.

Object Store

String

A reference to the object store to use to store each resource owner ID’s data. If this value is not specified, Mule automatically provisions the default object store.

## [](#operations)Operations - [Get Comments By Ids](#CreateRestApi3CommentList) - [Create Component](#CreateRestApi3Component) - [Create Custom Field Options](#CreateRestApi3CustomFieldOptionByFieldId) - [Create Dashboard](#CreateRestApi3Dashboard) - [Copy Dashboard](#CreateRestApi3DashboardCopyById) - [Analyse Expression](#CreateRestApi3ExpressionAnalyse) - [Evaluate Jira Expression](#CreateRestApi3ExpressionEval) - [Create Custom Field](#CreateRestApi3Field) - [Create Custom Field Context](#CreateRestApi3FieldContextByFieldId) - [Remove Issue Types From Context](#CreateRestApi3FieldContextIssuetypeRemoveByFieldIdContextId) - [Get Custom Field Contexts For Projects And Issue Types](#CreateRestApi3FieldContextMappingByFieldId) - [Create Custom Field Option](#CreateRestApi3FieldContextOptionByFieldIdContextId) - [Remove Custom Field Context From Projects](#CreateRestApi3FieldContextProjectRemoveByFieldIdContextId) - [Create Issue Field Option](#CreateRestApi3FieldOptionByFieldKey) - [Create Filter](#CreateRestApi3Filter) - [Add Share Permission](#CreateRestApi3FilterPermissionById) - [Create Group](#CreateRestApi3Group) - [Add User To Group](#CreateRestApi3GroupUser) - [Create Issue](#CreateRestApi3Issue) - [Add Attachment](#CreateRestApi3IssueAttachmentsByIssueIdOrKey) - [Create Issues](#CreateRestApi3IssueBulk) - [Add Comment](#CreateRestApi3IssueCommentByIssueIdOrKey) - [Link Issues](#CreateRestApi3IssueLink) - [Create Issue Link Type](#CreateRestApi3IssueLinkType) - [Notify](#CreateRestApi3IssueNotifyByIssueIdOrKey) - [Bulk Set Issues Properties](#CreateRestApi3IssueProperties) - [Create Or Update Remote Issue Link](#CreateRestApi3IssueRemotelinkByIssueIdOrKey) - [Do Transition](#CreateRestApi3IssueTransitionsByIssueIdOrKey) - [Add Vote](#CreateRestApi3IssueVotesByIssueIdOrKey) - [Add Watcher](#CreateRestApi3IssueWatchersByIssueIdOrKey) - [Add Worklog](#CreateRestApi3IssueWorklogByIssueIdOrKey) - [Create Issue Type](#CreateRestApi3Issuetype) - [Create Issue Type Avatar](#CreateRestApi3IssuetypeAvatar2ById) - [Create Issue Type Scheme](#CreateRestApi3Issuetypescheme) - [Create Issue Type Screen Scheme](#CreateRestApi3Issuetypescreenscheme) - [Remove Mappings From Issue Type Screen Scheme](#CreateRestApi3IssuetypescreenschemeMappingRemoveByIssueTypeScreenSchemeId) - [Match Issues](#CreateRestApi3JqlMatch) - [Parse Jql Queries](#CreateRestApi3JqlParse) - [Migrate Queries](#CreateRestApi3JqlPdcleaner) - [Get Bulk Permissions](#CreateRestApi3PermissionsCheck) - [Get Permitted Projects](#CreateRestApi3PermissionsProject) - [Create Permission Scheme](#CreateRestApi3Permissionscheme) - [Create Permission Grant](#CreateRestApi3PermissionschemePermissionBySchemeId) - [Create Project](#CreateRestApi3Project) - [Archive Project](#CreateRestApi3ProjectArchiveByProjectIdOrKey) - [Create Project Avatar](#CreateRestApi3ProjectAvatar2ByProjectIdOrKey) - [Create Project Category](#CreateRestApi3ProjectCategory) - [Delete Project Asynchronously](#CreateRestApi3ProjectDeleteByProjectIdOrKey) - [restore](#CreateRestApi3ProjectRestoreByProjectIdOrKey) - [Add Actor Users](#CreateRestApi3ProjectRoleByProjectIdOrKeyId) - [Create Project Role](#CreateRestApi3Role) - [Add Project Role Actors To Role](#CreateRestApi3RoleActorsById) - [Partial Update Project Role](#CreateRestApi3RoleById) - [Create Screen](#CreateRestApi3Screens) - [Add Field To Default Screen](#CreateRestApi3ScreensAddToDefaultByFieldId) - [Add Screen Tab](#CreateRestApi3ScreensTabsByScreenId) - [Add Screen Tab Field](#CreateRestApi3ScreensTabsFieldsByScreenIdTabId) - [Move Screen Tab Field](#CreateRestApi3ScreensTabsFieldsMoveByScreenIdTabIdId) - [Move Screen Tab](#CreateRestApi3ScreensTabsMoveByScreenIdTabIdPos) - [Create Screen Scheme](#CreateRestApi3Screenscheme) - [Search For Issues Using Jql Post](#CreateRestApi3Search) - [Cancel Task](#CreateRestApi3TaskCancelByTaskId) - [Store Avatar](#CreateRestApi3UniversalAvatarTypeOwnerByTypeEntityId) - [Create User](#CreateRestApi3User) - [Create Version](#CreateRestApi3Version) - [Move Version](#CreateRestApi3VersionMoveById) - [Delete And Replace Version](#CreateRestApi3VersionRemoveAndSwapById) - [Register Dynamic Webhooks](#CreateRestApi3Webhook) - [Create Workflow Transition Property](#CreateRestApi3WorkflowTransitionsPropertiesByTransitionId) - [Create Workflow Scheme](#CreateRestApi3Workflowscheme) - [Create Workflow Scheme Draft From Parent](#CreateRestApi3WorkflowschemeCreatedraftById) - [Get Worklogs For Ids](#CreateRestApi3WorklogList) - [Dynamic Modules Resource register Modules post](#CreateRestAtlassianConnect1AppModuleDynamic) - [Remove Attachment](#DeleteRestApi3AttachmentById) - [Delete Comment Property](#DeleteRestApi3CommentPropertiesByCommentIdPropertyKey) - [Delete Component](#DeleteRestApi3ComponentById) - [Delete Dashboard](#DeleteRestApi3DashboardById) - [Delete Dashboard Item Property](#DeleteRestApi3DashboardItemsPropertiesByDashboardIdItemIdPropertyKey) - [Delete Custom Field Context](#DeleteRestApi3FieldContextByFieldIdContextId) - [Delete Custom Field Option](#DeleteRestApi3FieldContextOptionByFieldIdContextIdOptionId) - [Delete Issue Field Option](#DeleteRestApi3FieldOptionByFieldKeyOptionId) - [Replace Issue Field Option](#DeleteRestApi3FieldOptionIssueByFieldKeyOptionId) - [Delete Filter](#DeleteRestApi3FilterById) - [Reset Columns](#DeleteRestApi3FilterColumnsById) - [Delete Favourite For Filter](#DeleteRestApi3FilterFavouriteById) - [Delete Share Permission](#DeleteRestApi3FilterPermissionByIdPermissionId) - [Remove Group](#DeleteRestApi3Group) - [Remove User From Group](#DeleteRestApi3GroupUser) - [Delete Issue](#DeleteRestApi3IssueByIssueIdOrKey) - [Delete Comment](#DeleteRestApi3IssueCommentByIssueIdOrKeyId) - [Delete Issue Link](#DeleteRestApi3IssueLinkByLinkId) - [Delete Issue Link Type](#DeleteRestApi3IssueLinkTypeByIssueLinkTypeId) - [Delete Issue Property](#DeleteRestApi3IssuePropertiesByIssueIdOrKeyPropertyKey) - [Bulk Delete Issue Property](#DeleteRestApi3IssuePropertiesByPropertyKey) - [Delete Remote Issue Link By Global Id](#DeleteRestApi3IssueRemotelinkByIssueIdOrKey) - [Delete Remote Issue Link By Id](#DeleteRestApi3IssueRemotelinkByIssueIdOrKeyLinkId) - [Remove Vote](#DeleteRestApi3IssueVotesByIssueIdOrKey) - [Remove Watcher](#DeleteRestApi3IssueWatchersByIssueIdOrKey) - [Delete Worklog](#DeleteRestApi3IssueWorklogByIssueIdOrKeyId) - [Delete Worklog Property](#DeleteRestApi3IssueWorklogPropertiesByIssueIdOrKeyWorklogIdPropertyKey) - [Delete Issue Type](#DeleteRestApi3IssuetypeById) - [Delete Issue Type Property](#DeleteRestApi3IssuetypePropertiesByIssueTypeIdPropertyKey) - [Delete Issue Type Scheme](#DeleteRestApi3IssuetypeschemeByIssueTypeSchemeId) - [Remove Issue Type From Issue Type Scheme](#DeleteRestApi3IssuetypeschemeIssuetypeByIssueTypeSchemeIdIssueTypeId) - [Delete Issue Type Screen Scheme](#DeleteRestApi3IssuetypescreenschemeByIssueTypeScreenSchemeId) - [Remove Preference](#DeleteRestApi3Mypreferences) - [Delete Permission Scheme](#DeleteRestApi3PermissionschemeBySchemeId) - [Delete Permission Scheme Entity](#DeleteRestApi3PermissionschemePermissionBySchemeIdPermissionId) - [Delete Project Avatar](#DeleteRestApi3ProjectAvatarByProjectIdOrKeyId) - [Delete Project](#DeleteRestApi3ProjectByProjectIdOrKey) - [Remove Project Category](#DeleteRestApi3ProjectCategoryById) - [Delete Project Property](#DeleteRestApi3ProjectPropertiesByProjectIdOrKeyPropertyKey) - [Delete Actor](#DeleteRestApi3ProjectRoleByProjectIdOrKeyId) - [Delete Project Role Actors From Role](#DeleteRestApi3RoleActorsById) - [Delete Project Role](#DeleteRestApi3RoleById) - [Delete Screen](#DeleteRestApi3ScreensByScreenId) - [Delete Screen Tab](#DeleteRestApi3ScreensTabsByScreenIdTabId) - [Remove Screen Tab Field](#DeleteRestApi3ScreensTabsFieldsByScreenIdTabIdId) - [Delete Screen Scheme](#DeleteRestApi3ScreenschemeByScreenSchemeId) - [Delete Avatar](#DeleteRestApi3UniversalAvatarTypeOwnerAvatarByTypeOwningObjectIdId) - [Remove User](#DeleteRestApi3User) - [Reset User Columns](#DeleteRestApi3UserColumns) - [Delete User Property](#DeleteRestApi3UserPropertiesByPropertyKey) - [Delete Webhook By Id](#DeleteRestApi3Webhook) - [Delete Workflow Transition Property](#DeleteRestApi3WorkflowTransitionsPropertiesByTransitionId) - [Delete Workflow Scheme](#DeleteRestApi3WorkflowschemeById) - [Delete Default Workflow](#DeleteRestApi3WorkflowschemeDefaultById) - [Delete Workflow Scheme Draft](#DeleteRestApi3WorkflowschemeDraftById) - [Delete Draft Default Workflow](#DeleteRestApi3WorkflowschemeDraftDefaultById) - [Delete Workflow Scheme Draft Issue Type](#DeleteRestApi3WorkflowschemeDraftIssuetypeByIdIssueType) - [Delete Draft Workflow Mapping](#DeleteRestApi3WorkflowschemeDraftWorkflowById) - [Delete Workflow Scheme Issue Type](#DeleteRestApi3WorkflowschemeIssuetypeByIdIssueType) - [Delete Workflow Mapping](#DeleteRestApi3WorkflowschemeWorkflowById) - [Addon Properties Resource delete Addon Property delete](#DeleteRestAtlassianConnect1AddonsPropertiesByAddonKeyPropertyKey) - [Dynamic Modules Resource remove Modules delete](#DeleteRestAtlassianConnect1AppModuleDynamic) - [Get Application Property](#GetRestApi3ApplicationProperties) - [Get Advanced Settings](#GetRestApi3ApplicationPropertiesAdvancedSettings) - [Get All Application Roles](#GetRestApi3Applicationrole) - [Get Application Role](#GetRestApi3ApplicationroleByKey) - [Get Attachment](#GetRestApi3AttachmentById) - [Expand Attachment For Humans](#GetRestApi3AttachmentExpandHumanById) - [Expand Attachment For Machines](#GetRestApi3AttachmentExpandRawById) - [Get Attachment Meta](#GetRestApi3AttachmentMeta) - [Get Audit Records](#GetRestApi3AuditingRecord) - [Get All System Avatars](#GetRestApi3AvatarSystemByType) - [Get Comment Property Keys](#GetRestApi3CommentPropertiesByCommentId) - [Get Comment Property](#GetRestApi3CommentPropertiesByCommentIdPropertyKey) - [Get Component](#GetRestApi3ComponentById) - [Get Component Related Issues](#GetRestApi3ComponentRelatedIssueCountsById) - [Get Configuration](#GetRestApi3Configuration) - [Get Selected Time Tracking Implementation](#GetRestApi3ConfigurationTimetracking) - [Get Available Time Tracking Implementations](#GetRestApi3ConfigurationTimetrackingList) - [Get Shared Time Tracking Configuration](#GetRestApi3ConfigurationTimetrackingOptions) - [Get Options For Field](#GetRestApi3CustomFieldOptionByFieldId) - [Get All Dashboards](#GetRestApi3Dashboard) - [Get Dashboard](#GetRestApi3DashboardById) - [Get Dashboard Item Property Keys](#GetRestApi3DashboardItemsPropertiesByDashboardIdItemId) - [Get Dashboard Item Property](#GetRestApi3DashboardItemsPropertiesByDashboardIdItemIdPropertyKey) - [Get Dashboards Paginated](#GetRestApi3DashboardSearch) - [Get Fields](#GetRestApi3Field) - [Get Contexts For Field](#GetRestApi3FieldContextByFieldId) - [Get Default Values](#GetRestApi3FieldContextDefaultValueByFieldId) - [Get Issue Type Mappings For Contexts](#GetRestApi3FieldContextIssueTypeMappingByFieldId) - [Get Options For Context](#GetRestApi3FieldContextOptionByFieldIdContextId) - [Get Project Context Mapping](#GetRestApi3FieldContextProjectmappingByFieldId) - [Get All Issue Field Options](#GetRestApi3FieldOptionByFieldKey) - [Get Issue Field Option](#GetRestApi3FieldOptionByFieldKeyOptionId) - [Get Selectable Issue Field Options](#GetRestApi3FieldOptionSuggestionsEditByFieldKey) - [Get Visible Issue Field Options](#GetRestApi3FieldOptionSuggestionsSearchByFieldKey) - [Get Screens For Field](#GetRestApi3FieldScreensByFieldId) - [Get Fields Paginated](#GetRestApi3FieldSearch) - [Get All Field Configurations](#GetRestApi3Fieldconfiguration) - [Get Field Configuration Items](#GetRestApi3FieldconfigurationFieldsById) - [Get All Field Configuration Schemes](#GetRestApi3Fieldconfigurationscheme) - [Get Field Configuration Scheme Mappings](#GetRestApi3FieldconfigurationschemeMapping) - [Get Field Configuration Scheme Project Mapping](#GetRestApi3FieldconfigurationschemeProject) - [Get Filter](#GetRestApi3FilterById) - [Get Columns](#GetRestApi3FilterColumnsById) - [Get Default Share Scope](#GetRestApi3FilterDefaultShareScope) - [Get Favourite Filters](#GetRestApi3FilterFavourite) - [Get My Filters](#GetRestApi3FilterMy) - [Get Share Permissions](#GetRestApi3FilterPermissionById) - [Get Share Permission](#GetRestApi3FilterPermissionByIdPermissionId) - [Get Filters Paginated](#GetRestApi3FilterSearch) - [Bulk Get Groups](#GetRestApi3GroupBulk) - [Get Users From Group](#GetRestApi3GroupMember) - [Find Groups](#GetRestApi3GroupsPicker) - [Find Users And Groups](#GetRestApi3Groupuserpicker) - [Get Issue](#GetRestApi3IssueByIssueIdOrKey) - [Get Change Logs](#GetRestApi3IssueChangelogByIssueIdOrKey) - [Get Comments](#GetRestApi3IssueCommentByIssueIdOrKey) - [Get Comment](#GetRestApi3IssueCommentByIssueIdOrKeyId) - [Get Create Issue Meta](#GetRestApi3IssueCreatemeta) - [Get Edit Issue Meta](#GetRestApi3IssueEditmetaByIssueIdOrKey) - [Get Issue Link](#GetRestApi3IssueLinkByLinkId) - [Get Issue Link Types](#GetRestApi3IssueLinkType) - [Get Issue Link Type](#GetRestApi3IssueLinkTypeByIssueLinkTypeId) - [Get Issue Picker Resource](#GetRestApi3IssuePicker) - [Get Issue Property Keys](#GetRestApi3IssuePropertiesByIssueIdOrKey) - [Get Issue Property](#GetRestApi3IssuePropertiesByIssueIdOrKeyPropertyKey) - [Get Remote Issue Links](#GetRestApi3IssueRemotelinkByIssueIdOrKey) - [Get Remote Issue Link By Id](#GetRestApi3IssueRemotelinkByIssueIdOrKeyLinkId) - [Get Transitions](#GetRestApi3IssueTransitionsByIssueIdOrKey) - [Get Votes](#GetRestApi3IssueVotesByIssueIdOrKey) - [Get Issue Watchers](#GetRestApi3IssueWatchersByIssueIdOrKey) - [Get Issue Worklog](#GetRestApi3IssueWorklogByIssueIdOrKey) - [Get Worklog](#GetRestApi3IssueWorklogByIssueIdOrKeyId) - [Get Worklog Property Keys](#GetRestApi3IssueWorklogPropertiesByIssueIdOrKeyWorklogId) - [Get Worklog Property](#GetRestApi3IssueWorklogPropertiesByIssueIdOrKeyWorklogIdPropertyKey) - [Get Issue Security Schemes](#GetRestApi3Issuesecurityschemes) - [Get Issue Security Scheme](#GetRestApi3IssuesecurityschemesById) - [Get Issue Security Level Members](#GetRestApi3IssuesecurityschemesMembersByIssueSecuritySchemeId) - [Get Issue All Types](#GetRestApi3Issuetype) - [Get Alternative Issue Types](#GetRestApi3IssuetypeAlternativesById) - [Get Issue Type](#GetRestApi3IssuetypeById) - [Get Issue Type Property Keys](#GetRestApi3IssuetypePropertiesByIssueTypeId) - [Get Issue Type Property](#GetRestApi3IssuetypePropertiesByIssueTypeIdPropertyKey) - [Get All Issue Type Schemes](#GetRestApi3Issuetypescheme) - [Get Issue Type Schemes Mapping](#GetRestApi3IssuetypeschemeMapping) - [Get Issue Type Scheme For Projects](#GetRestApi3IssuetypeschemeProject) - [Get Issue Type Screen Schemes](#GetRestApi3Issuetypescreenscheme) - [Get Issue Type Screen Scheme Mappings](#GetRestApi3IssuetypescreenschemeMapping) - [Get Issue Type Screen Scheme Project Associations](#GetRestApi3IssuetypescreenschemeProject) - [Get Auto Complete](#GetRestApi3JqlAutocompletedata) - [Get Field Auto Complete For Query String](#GetRestApi3JqlAutocompletedataSuggestions) - [Get All Labels](#GetRestApi3Label) - [Get My Permissions](#GetRestApi3Mypermissions) - [Get Preference](#GetRestApi3Mypreferences) - [Get Locale](#GetRestApi3MypreferencesLocale) - [Get Current User](#GetRestApi3Myself) - [Get Notification Schemes](#GetRestApi3Notificationscheme) - [Get Notification Scheme](#GetRestApi3NotificationschemeById) - [Get All Permissions](#GetRestApi3Permissions) - [Get All Permission Schemes](#GetRestApi3Permissionscheme) - [Get Permission Scheme](#GetRestApi3PermissionschemeBySchemeId) - [Get Permission Scheme Grants](#GetRestApi3PermissionschemePermissionBySchemeId) - [Get Permission Scheme Grant](#GetRestApi3PermissionschemePermissionBySchemeIdPermissionId) - [Get Priorities](#GetRestApi3Priority) - [Get Priority](#GetRestApi3PriorityById) - [Get All Project Avatars](#GetRestApi3ProjectAvatarsByProjectIdOrKey) - [Get Project](#GetRestApi3ProjectByProjectIdOrKey) - [Get All Project Categories](#GetRestApi3ProjectCategory) - [Get Project Category By Id](#GetRestApi3ProjectCategoryById) - [Get Project Components Paginated](#GetRestApi3ProjectComponentByProjectIdOrKey) - [Get Project Components](#GetRestApi3ProjectComponentsByProjectIdOrKey) - [Get Project Email](#GetRestApi3ProjectEmailByProjectId) - [Get Hierarchy](#GetRestApi3ProjectHierarchyByProjectId) - [Get Project Issue Security Scheme](#GetRestApi3ProjectIssuesecuritylevelschemeByProjectKeyOrId) - [Get Notification Scheme For Project](#GetRestApi3ProjectNotificationschemeByProjectKeyOrId) - [Get Assigned Permission Scheme](#GetRestApi3ProjectPermissionschemeByProjectKeyOrId) - [Get Project Property Keys](#GetRestApi3ProjectPropertiesByProjectIdOrKey) - [Get Project Property](#GetRestApi3ProjectPropertiesByProjectIdOrKeyPropertyKey) - [Get Project Roles](#GetRestApi3ProjectRoleByProjectIdOrKey) - [Get Project Role](#GetRestApi3ProjectRoleByProjectIdOrKeyId) - [Get Project Role Details](#GetRestApi3ProjectRoledetailsByProjectIdOrKey) - [Search Projects](#GetRestApi3ProjectSearch) - [Get Security Levels For Project](#GetRestApi3ProjectSecuritylevelByProjectKeyOrId) - [Get All Statuses](#GetRestApi3ProjectStatusesByProjectIdOrKey) - [Get All Project Types](#GetRestApi3ProjectType) - [Get All Accessible Project Types](#GetRestApi3ProjectTypeAccessible) - [Get Accessible Project Type By Key](#GetRestApi3ProjectTypeAccessibleByProjectTypeKey) - [Get Project Type By Key](#GetRestApi3ProjectTypeByProjectTypeKey) - [Get Project Versions Paginated](#GetRestApi3ProjectVersionByProjectIdOrKey) - [Get Project Versions](#GetRestApi3ProjectVersionsByProjectIdOrKey) - [Validate Project Key](#GetRestApi3ProjectvalidateKey) - [Get Valid Project Key](#GetRestApi3ProjectvalidateValidProjectKey) - [Get Valid Project Name](#GetRestApi3ProjectvalidateValidProjectName) - [Get Resolutions](#GetRestApi3Resolution) - [Get Resolution](#GetRestApi3ResolutionById) - [Get All Project Roles](#GetRestApi3Role) - [Get Project Role Actors For Role](#GetRestApi3RoleActorsById) - [Get Project Role By Id](#GetRestApi3RoleById) - [Get Screens](#GetRestApi3Screens) - [Get Available Screen Fields](#GetRestApi3ScreensAvailableFieldsByScreenId) - [Get All Screen Tabs](#GetRestApi3ScreensTabsByScreenId) - [Get All Screen Tab Fields](#GetRestApi3ScreensTabsFieldsByScreenIdTabId) - [Get Screen Schemes](#GetRestApi3Screenscheme) - [(Deprecated) Search For Issues Using JQL](#GetRestApi3Search) - [Search For Issues Using JQL (Paginated)](#GetRestApi3SearchPaginated) - [Get Issue Security Level](#GetRestApi3SecuritylevelById) - [Get Server Info](#GetRestApi3ServerInfo) - [Get Issue Navigator Default Columns](#GetRestApi3SettingsColumns) - [Get Statuses](#GetRestApi3Status) - [Get Status](#GetRestApi3StatusByIdOrName) - [Get Status Categories](#GetRestApi3Statuscategory) - [Get Status Category](#GetRestApi3StatuscategoryByIdOrKey) - [Get Task](#GetRestApi3TaskByTaskId) - [Get Avatars](#GetRestApi3UniversalAvatarTypeOwnerByTypeEntityId) - [Get User](#GetRestApi3User) - [Find Bulk Assignable Users](#GetRestApi3UserAssignableMultiProjectSearch) - [Find Assignable Users](#GetRestApi3UserAssignableSearch) - [Bulk Get Users](#GetRestApi3UserBulk) - [Bulk Get Users Migration](#GetRestApi3UserBulkMigration) - [Get User Default Columns](#GetRestApi3UserColumns) - [Get User Email](#GetRestApi3UserEmail) - [Get User Email Bulk](#GetRestApi3UserEmailBulk) - [Get User Groups](#GetRestApi3UserGroups) - [Find Users With All Permissions](#GetRestApi3UserPermissionSearch) - [Find Users For Picker](#GetRestApi3UserPicker) - [Get User Property Keys](#GetRestApi3UserProperties) - [Get User Property](#GetRestApi3UserPropertiesByPropertyKey) - [Find Users](#GetRestApi3UserSearch) - [Find Users By Query](#GetRestApi3UserSearchQuery) - [Find User Keys By Query](#GetRestApi3UserSearchQueryKey) - [Find Users With Browse Permission](#GetRestApi3UserViewissueSearch) - [Get All Users Default](#GetRestApi3Users) - [Get All Users](#GetRestApi3UsersSearch) - [Get Version](#GetRestApi3VersionById) - [Get Version Related Issues](#GetRestApi3VersionRelatedIssueCountsById) - [Get Version Unresolved Issues](#GetRestApi3VersionUnresolvedIssueCountById) - [Get Dynamic Webhooks For App](#GetRestApi3Webhook) - [Get Failed Webhooks](#GetRestApi3WebhookFailed) - [Get Workflow Transition Rule Configurations](#GetRestApi3WorkflowRuleConfig) - [Get Workflows Paginated](#GetRestApi3WorkflowSearch) - [Get Workflow Transition Properties](#GetRestApi3WorkflowTransitionsPropertiesByTransitionId) - [Get All Workflow Schemes](#GetRestApi3Workflowscheme) - [Get Workflow Scheme](#GetRestApi3WorkflowschemeById) - [Get Default Workflow](#GetRestApi3WorkflowschemeDefaultById) - [Get Workflow Scheme Draft](#GetRestApi3WorkflowschemeDraftById) - [Get Draft Default Workflow](#GetRestApi3WorkflowschemeDraftDefaultById) - [Get Workflow Scheme Draft Issue Type](#GetRestApi3WorkflowschemeDraftIssuetypeByIdIssueType) - [Get Draft Workflow](#GetRestApi3WorkflowschemeDraftWorkflowById) - [Get Workflow Scheme Issue Type](#GetRestApi3WorkflowschemeIssuetypeByIdIssueType) - [Get Workflow Scheme Project Associations](#GetRestApi3WorkflowschemeProject) - [Get Workflow](#GetRestApi3WorkflowschemeWorkflowById) - [Get Ids Of Worklogs Deleted Since](#GetRestApi3WorklogDeleted) - [Get Ids Of Worklogs Modified Since](#GetRestApi3WorklogUpdated) - [Addon Properties Resource get Addon Properties get](#GetRestAtlassianConnect1AddonsPropertiesByAddonKey) - [Addon Properties Resource get Addon Property get](#GetRestAtlassianConnect1AddonsPropertiesByAddonKeyPropertyKey) - [Dynamic Modules Resource get Modules get](#GetRestAtlassianConnect1AppModuleDynamic) - [Unauthorize](#Unauthorize) - [Set Application Property](#UpdateRestApi3ApplicationPropertiesById) - [Set Comment Property](#UpdateRestApi3CommentPropertiesByCommentIdPropertyKey) - [Update Component](#UpdateRestApi3ComponentById) - [Select Time Tracking Implementation](#UpdateRestApi3ConfigurationTimetracking) - [Set Shared Time Tracking Configuration](#UpdateRestApi3ConfigurationTimetrackingOptions) - [Update Custom Field Options](#UpdateRestApi3CustomFieldOptionByFieldId) - [Update Dashboard](#UpdateRestApi3DashboardById) - [Set Dashboard Item Property](#UpdateRestApi3DashboardItemsPropertiesByDashboardIdItemIdPropertyKey) - [Update Custom Field](#UpdateRestApi3FieldByFieldId) - [Update Custom Field Context](#UpdateRestApi3FieldContextByFieldIdContextId) - [Set Default Values](#UpdateRestApi3FieldContextDefaultValueByFieldId) - [Add Issue Types To Context](#UpdateRestApi3FieldContextIssuetypeByFieldIdContextId) - [Update Custom Field Option](#UpdateRestApi3FieldContextOptionByFieldIdContextId) - [Reorder Custom Field Options](#UpdateRestApi3FieldContextOptionMoveByFieldIdContextId) - [Assign Projects To Custom Field Context](#UpdateRestApi3FieldContextProjectByFieldIdContextId) - [Update Issue Field Option](#UpdateRestApi3FieldOptionByFieldKeyOptionId) - [Assign Field Configuration Scheme To Project](#UpdateRestApi3FieldconfigurationschemeProject) - [Update Filter](#UpdateRestApi3FilterById) - [Set Columns](#UpdateRestApi3FilterColumnsById) - [Set Default Share Scope](#UpdateRestApi3FilterDefaultShareScope) - [Set Favourite For Filter](#UpdateRestApi3FilterFavouriteById) - [Assign Issue](#UpdateRestApi3IssueAssigneeByIssueIdOrKey) - [Edit Issue](#UpdateRestApi3IssueByIssueIdOrKey) - [Update Comment](#UpdateRestApi3IssueCommentByIssueIdOrKeyId) - [Update Issue Link Type](#UpdateRestApi3IssueLinkTypeByIssueLinkTypeId) - [Set Issue Property](#UpdateRestApi3IssuePropertiesByIssueIdOrKeyPropertyKey) - [Bulk Set Issue Property](#UpdateRestApi3IssuePropertiesByPropertyKey) - [Update Remote Issue Link](#UpdateRestApi3IssueRemotelinkByIssueIdOrKeyLinkId) - [Update Worklog](#UpdateRestApi3IssueWorklogByIssueIdOrKeyId) - [Set Worklog Property](#UpdateRestApi3IssueWorklogPropertiesByIssueIdOrKeyWorklogIdPropertyKey) - [Update Issue Type](#UpdateRestApi3IssuetypeById) - [Set Issue Type Property](#UpdateRestApi3IssuetypePropertiesByIssueTypeIdPropertyKey) - [Update Issue Type Scheme](#UpdateRestApi3IssuetypeschemeByIssueTypeSchemeId) - [Add Issue Types To Issue Type Scheme](#UpdateRestApi3IssuetypeschemeIssuetypeByIssueTypeSchemeId) - [Reorder Issue Types In Issue Type Scheme](#UpdateRestApi3IssuetypeschemeIssuetypeMoveByIssueTypeSchemeId) - [Assign Issue Type Scheme To Project](#UpdateRestApi3IssuetypeschemeProject) - [Update Issue Type Screen Scheme](#UpdateRestApi3IssuetypescreenschemeByIssueTypeScreenSchemeId) - [Append Mappings For Issue Type Screen Scheme](#UpdateRestApi3IssuetypescreenschemeMappingByIssueTypeScreenSchemeId) - [Update Default Screen Scheme](#UpdateRestApi3IssuetypescreenschemeMappingDefaultByIssueTypeScreenSchemeId) - [Assign Issue Type Screen Scheme To Project](#UpdateRestApi3IssuetypescreenschemeProject) - [Set Preference](#UpdateRestApi3Mypreferences) - [Update Permission Scheme](#UpdateRestApi3PermissionschemeBySchemeId) - [Update Project Avatar](#UpdateRestApi3ProjectAvatarByProjectIdOrKey) - [Update Project](#UpdateRestApi3ProjectByProjectIdOrKey) - [Update Project Category](#UpdateRestApi3ProjectCategoryById) - [Update Project Email](#UpdateRestApi3ProjectEmailByProjectId) - [Assign Permission Scheme](#UpdateRestApi3ProjectPermissionschemeByProjectKeyOrId) - [Set Project Property](#UpdateRestApi3ProjectPropertiesByProjectIdOrKeyPropertyKey) - [Set Actors](#UpdateRestApi3ProjectRoleByProjectIdOrKeyId) - [Fully Update Project Role](#UpdateRestApi3RoleById) - [Update Screen](#UpdateRestApi3ScreensByScreenId) - [Rename Screen Tab](#UpdateRestApi3ScreensTabsByScreenIdTabId) - [Update Screen Scheme](#UpdateRestApi3ScreenschemeByScreenSchemeId) - [Set Issue Navigator Default Columns](#UpdateRestApi3SettingsColumns) - [Set User Columns](#UpdateRestApi3UserColumns) - [Set User Property](#UpdateRestApi3UserPropertiesByPropertyKey) - [Update Version](#UpdateRestApi3VersionById) - [Merge Versions](#UpdateRestApi3VersionMergetoByIdMoveIssuesTo) - [Refresh Webhooks](#UpdateRestApi3WebhookRefresh) - [Update Workflow Transition Rule Configurations](#UpdateRestApi3WorkflowRuleConfig) - [Update Workflow Transition Property](#UpdateRestApi3WorkflowTransitionsPropertiesByTransitionId) - [Update Workflow Scheme](#UpdateRestApi3WorkflowschemeById) - [Update Default Workflow](#UpdateRestApi3WorkflowschemeDefaultById) - [Update Workflow Scheme Draft](#UpdateRestApi3WorkflowschemeDraftById) - [Update Draft Default Workflow](#UpdateRestApi3WorkflowschemeDraftDefaultById) - [Set Workflow Scheme Draft Issue Type](#UpdateRestApi3WorkflowschemeDraftIssuetypeByIdIssueType) - [Update Draft Workflow Mapping](#UpdateRestApi3WorkflowschemeDraftWorkflowById) - [Set Workflow Scheme Issue Type](#UpdateRestApi3WorkflowschemeIssuetypeByIdIssueType) - [Associate Scheme With Project](#UpdateRestApi3WorkflowschemeProject) - [Update Workflow Mapping](#UpdateRestApi3WorkflowschemeWorkflowById) - [Addon Properties Resource put Addon Property put](#UpdateRestAtlassianConnect1AddonsPropertiesByAddonKeyPropertyKey) ## [](#operations-2)Operations ## [](#CreateRestApi3CommentList)Get Comments By Ids `` Returns a paginated list of just the comments for a list of comments specified by comment IDs. This operation can be accessed anonymously. **Permissions required:** Comments are returned when: - The user has **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project containing the comment. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. - If the comment has visibility restrictions, belongs to the group, or has the role visibility is restricted to. This operation makes an HTTP POST request to the /rest/api/3/comment/list endpoint ### [](#parameters-2)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
expand	String	Use `expand` to include additional information about comments in the response. This parameter accepts a comma-separated list. Expand options include: `renderedBody` Returns the comment body rendered in HTML. `properties` Returns the comment’s properties.
Body	Any	the content to use	#[payload]
Config Ref	ConfigurationProvider	The name of the configuration to use to execute this component
Streaming Strategy	Repeatable In Memory Stream Repeatable File Store Stream non-repeatable-stream	Configures how Mule processes streams. Repeatable streams are the default behavior.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

expand

String

Use expand to include additional information about comments in the response. This parameter accepts a comma-separated list. Expand options include:

renderedBody Returns the comment body rendered in HTML.
properties Returns the comment’s properties.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations)For Configurations - [Configurations](#Config) ### [](#throws)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3Component)Create Component `` Creates a component. Use components to provide containers for issues within a project. This operation can be accessed anonymously. **Permissions required:** - **Administer projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project in which the component is created - **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP POST request to the /rest/api/3/component endpoint. ### [](#parameters-3)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
Body	Any	the content to use	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Streaming Strategy	Repeatable In Memory Stream Repeatable File Store Stream non-repeatable-stream	Configures how Mule processes streams. Repeatable streams are the default behavior.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-2)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-2)For Configurations - [Configurations](#Config) ### [](#throws-2)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3CustomFieldOptionByFieldId)Create Custom Field Options `` This operation is deprecated and becomes unavailable on 8 May 2021. Use [Create custom field options (context)](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-custom-field-options/#api-rest-api-3-field-fieldid-context-contextid-option-post) instead. See [Deprecation of custom field options](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-removal-of-custom-field-options-operations/) for details. Creates options and, where the custom select field is of the type **Select List (cascading)**, cascading options for a custom select field. The options are added to the global context of the field. Note that this operation **only works for issue field select list options created in Jira or using operations from the \[Issue custom field options\](#api-group-Issue-custom-field-options) resource**, it cannot be used with issue field select list options created by Connect apps. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP POST request to the /rest/api/3/customField/{fieldId}/option endpoint. ### [](#parameters-4)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
Field Id	Number	The ID of the custom field. Note: This is the numeric part of the of the field ID. For example, for a field with the ID customfield\_10075 use 10075.		x
Body	Any	the content to use	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

Field Id

Number

The ID of the custom field. Note: This is the numeric part of the of the field ID. For example, for a field with the ID customfield\_10075 use 10075.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-3)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-3)For Configurations - [Configurations](#Config) ### [](#throws-3)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3Dashboard)Create Dashboard `` Creates a dashboard. **Permissions required:** None. This operation makes an HTTP POST request to the /rest/api/3/dashboard endpoint. ### [](#parameters-5)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
Body	Any	the content to use	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Streaming Strategy	Repeatable In Memory Stream Repeatable File Store Stream non-repeatable-stream	Configures how Mule processes streams. Repeatable streams are the default behavior.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-4)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-4)For Configurations - [Configurations](#Config) ### [](#throws-4)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3DashboardCopyById)Copy Dashboard `` Copies a dashboard. Any values provided in the `dashboard` parameter replace those in the copied dashboard. **Permissions required:** None The dashboard to be copied must be owned by or shared with the user. This operation makes an HTTP POST request to the /rest/api/3/dashboard/{id}/copy endpoint. ### [](#parameters-6)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
id	String	id		x
Body	Any	the content to use	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Streaming Strategy	Repeatable In Memory Stream Repeatable File Store Stream non-repeatable-stream	Configures how Mule processes streams. Repeatable streams are the default behavior.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

String

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-5)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-5)For Configurations - [Configurations](#Config) ### [](#throws-5)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3ExpressionAnalyse)Analyse Expression `` Analyzes and validates Jira expressions. As an experimental feature, this operation can also attempt to type-check the expressions. Learn more about Jira expressions in the [documentation](https://developer.atlassian.com/cloud/jira/platform/jira-expressions/). **Permissions required**: None. This operation makes an HTTP POST request to the /rest/api/3/expression/analyse endpoint. ### [](#parameters-7)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
check	Enumeration, one of: SYNTAX TYPE COMPLEXITY	The check to perform: `syntax` Each expression’s syntax is checked to ensure the expression can be parsed. Also, syntactic limits are validated. For example, the expression’s length. `type` EXPERIMENTAL. Each expression is type checked and the final type of the expression inferred. Any type errors that would result in the expression failure at runtime are reported. For example, accessing properties that don’t exist or passing the wrong number of arguments to functions. Also performs the syntax check. `complexity` EXPERIMENTAL. Determines the formulae for how many expensive operations each expression may execute.	SYNTAX
Body	Any	the content to use	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Streaming Strategy	Repeatable In Memory Stream Repeatable File Store Stream non-repeatable-stream	Configures how Mule processes streams. Repeatable streams are the default behavior.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

check

Enumeration, one of:

SYNTAX
TYPE
COMPLEXITY

The check to perform:

syntax Each expression’s syntax is checked to ensure the expression can be parsed. Also, syntactic limits are validated. For example, the expression’s length.
type EXPERIMENTAL. Each expression is type checked and the final type of the expression inferred. Any type errors that would result in the expression failure at runtime are reported. For example, accessing properties that don’t exist or passing the wrong number of arguments to functions. Also performs the syntax check.
complexity EXPERIMENTAL. Determines the formulae for how many expensive operations each expression may execute.

SYNTAX

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-6)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-6)For Configurations - [Configurations](#Config) ### [](#throws-6)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3ExpressionEval)Evaluate Jira Expression `` Evaluates a Jira expression and returns its value. This resource can be used to test Jira expressions that you plan to use elsewhere, or to fetch data in a flexible way. Consult the [Jira expressions documentation](https://developer.atlassian.com/cloud/jira/platform/jira-expressions/) for more details. **Context variables** The following context variables are available to Jira expressions evaluated by this resource. Their presence depends on various factors; usually you need to manually request them in the context object sent in the payload, but some of them are added automatically under certain conditions. - `user` ([User](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference/)): The current user. Always available and equal to `null` if the request is anonymous. - `app` ([App](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference/)): The Connect app that made the request. Available only for authenticated requests made by Connect Apps (read more here: [Authentication for Connect apps](https://developer.atlassian.com/cloud/jira/platform/security-for-connect-apps/)). - `issue` ([Issue](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference/)): The current issue. Available only when the issue is provided in the request context object. - `issues` ([List](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference/) of [Issues](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference/)): A collection of issues matching a JQL query. Available only when JQL is provided in the request context object. - `project` ([Project](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference/)): The current project. Available only when the project is provided in the request context object. - `sprint` ([Sprint](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference/)): The current sprint. Available only when the sprint is provided in the request context object. - `board` ([Board](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference/)): The current board. Available only when the board is provided in the request context object. - `serviceDesk` ([ServiceDesk](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference/)): The current service desk. Available only when the service desk is provided in the request context object. - `customerRequest` ([CustomerRequest](https://developer.atlassian.com/cloud/jira/platform/jira-expressions-type-reference/)): The current customer request. Available only when the customer request is provided in the request context object. This operation can be accessed anonymously. **Permissions required**: None. However, an expression may return different results for different users depending on their permissions. For example, different users may see different comments on the same issue. Permission to access Jira Software is required to access Jira Software context variables (`board` and `sprint`) or fields (for example, `issue.sprint`). This operation makes an HTTP POST request to the /rest/api/3/expression/evaluate endpoint. ### [](#parameters-8)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
expand	String	Use `expand` to include additional information in the response. This parameter accepts `meta.complexity` that returns information about the expression complexity. For example, the number of expensive operations used by the expression and how close the expression is to reaching the [complexity limit](https://docs.mulesoft.com/jira-connector/latest/%3Ca href="https://developer.atlassian.com/cloud/jira/platform/jira-expressions/#restrictions" class="bare">https://developer.atlassian.com/cloud/jira/platform/jira-expressions/#restrictions). Useful when designing and debugging your expressions.
Body	Any	Content to use	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Streaming Strategy	Repeatable In Memory Stream Repeatable File Store Stream non-repeatable-stream	Configures how Mule processes streams. Repeatable streams are the default behavior.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

expand

String

Use expand to include additional information in the response. This parameter accepts meta.complexity that returns information about the expression complexity. For example, the number of expensive operations used by the expression and how close the expression is to reaching the [complexity limit](https://docs.mulesoft.com/jira-connector/latest/%3Ca href="https://developer.atlassian.com/cloud/jira/platform/jira-expressions/#restrictions" class="bare">https://developer.atlassian.com/cloud/jira/platform/jira-expressions/#restrictions). Useful when designing and debugging your expressions.

Body

Any

Content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-7)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-7)For Configurations - [Configurations](#Config) ### [](#throws-7)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3Field)Create Custom Field `` Creates a custom field. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP POST request to the /rest/api/3/field endpoint. ### [](#parameters-9)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
Body	Any	the content to use	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Streaming Strategy	Repeatable In Memory Stream Repeatable File Store Stream non-repeatable-stream	Configures how Mule processes streams. Repeatable streams are the default behavior.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-8)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-8)For Configurations - [Configurations](#Config) ### [](#throws-8)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3FieldContextByFieldId)Create Custom Field Context `` Creates a custom field context. If `projectIds` is empty, a global context is created. A global context is one that applies to all project. If `issueTypeIds` is empty, the context applies to all issue types. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP POST request to the /rest/api/3/field/{fieldId}/context endpoint. ### [](#parameters-10)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
Field Id	String	The ID of the custom field.		x
Body	Any	the content to use	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Streaming Strategy	Repeatable In Memory Stream Repeatable File Store Stream non-repeatable-stream	Configures how Mule processes streams. Repeatable streams are the default behavior.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

Field Id

String

The ID of the custom field.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-9)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-9)For Configurations - [Configurations](#Config) ### [](#throws-9)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3FieldContextIssuetypeRemoveByFieldIdContextId)Remove Issue Types From Context `` Removes issue types from a custom field context. A custom field context without any issue types applies to all issue types. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP POST request to the /rest/api/3/field/{fieldId}/context/{contextId}/issuetype/remove endpoint. ### [](#parameters-11)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
Field Id	String	The ID of the custom field.		x
Context Id	Number	The ID of the context.		x
Body	Any	the content to use	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	Timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

Field Id

String

The ID of the custom field.

Context Id

Number

The ID of the context.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

Timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-10)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-10)For Configurations - [Configurations](#Config) ### [](#throws-10)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3FieldContextMappingByFieldId)Get Custom Field Contexts For Projects And Issue Types `` Returns a paginated list of project and issue type mappings and, for each mapping, the ID of a [custom field context](https://confluence.atlassian.com/x/k44fOw) that applies to the project and issue type. If there is no custom field context assigned to the project then, if present, the custom field context that applies to all projects is returned if it also applies to the issue type or all issue types. If a custom field context is not found, the returned custom field context ID is `null`. Duplicate project and issue type mappings cannot be provided in the request. The order of the returned values is the same as provided in the request. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP POST request to the /rest/api/3/field/{fieldId}/context/mapping endpoint. ### [](#parameters-12)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
Field Id	String	The ID of the custom field.		x
Start At	Number	The index of the first item to return in a page of results (page offset).	0
Max Results	Number	The maximum number of items to return per page.	50
Body	Any	the content to use	#[payload]
Output Mime Type	String	The MIME type of the payload that this operation outputs.
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Streaming Strategy	Repeatable In Memory Iterable Repeatable File Store Iterable non-repeatable-iterable	Configures how Mule processes streams. Repeatable streams are the default behavior.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

Field Id

String

The ID of the custom field.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Body

Any

the content to use

#[payload]

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Iterable
Repeatable File Store Iterable
non-repeatable-iterable

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-11)Output

Type

Array of * Any

### [](#for-configurations-11)For Configurations - [Configurations](#Config) ### [](#throws-11)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3FieldContextOptionByFieldIdContextId)Create Custom Field Option `` Creates options and, where the custom select field is of the type Select List (cascading), cascading options for a custom select field. The options are added to a context of the field. The maximum number of options that can be created per request is 1000 and each field can have a maximum of 10000 options. This operation works for custom field options created in Jira or the operations from this resource. To work with the issue field, select list options created for Connect apps use the **Issue custom field options** operations. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP POST request to the /rest/api/3/field/{fieldId}/context/{contextId}/option endpoint. ### [](#parameters-13)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
Field Id	String	The ID of the custom field.		x
Context Id	Number	The ID of the context.		x
Body	Any	the content to use	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Streaming Strategy	Repeatable In Memory Stream Repeatable File Store Stream non-repeatable-stream	Configures how Mule processes streams. Repeatable streams are the default behavior.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

Field Id

String

The ID of the custom field.

Context Id

Number

The ID of the context.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-12)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-12)For Configurations - [Configurations](#Config) ### [](#throws-12)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3FieldContextProjectRemoveByFieldIdContextId)Remove Custom Field Context From Projects `` Removes a custom field context from projects. A custom field context without any projects applies to all projects. Removing all projects from a custom field context would result in it applying to all projects. If any project in the request is not assigned to the context, or the operation would result in two global contexts for the field, the operation fails. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP POST request to the /rest/api/3/field/{fieldId}/context/{contextId}/project/remove endpoint. ### [](#parameters-14)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
Field Id	String	The ID of the custom field.		x
Context Id	Number	The ID of the context.		x
Body	Any	the content to use	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

Field Id

String

The ID of the custom field.

Context Id

Number

The ID of the context.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-13)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-13)For Configurations - [Configurations](#Config) ### [](#throws-13)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3FieldOptionByFieldKey)Create Issue Field Option `` Creates an option for a select list issue field. Note that this operation **only works for issue field select list options added by Connect apps**, it cannot be used with issue field select list options created in Jira or using operations from the \[Issue custom field options\](#api-group-Issue-custom-field-options) resource. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). Jira permissions are not required for the app providing the field. This operation makes an HTTP POST request to the /rest/api/3/field/{fieldKey}/option endpoint. ### [](#parameters-15)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
Field Key	String	The field key is specified in the following format: `$(app-key)_\_$(field-key)`. For example, `example-add-on\_\_example-issue-field`. To determine the `fieldKey` value, do one of the following: Open the app’s plugin descriptor, then app-key is the key at the top and field-key is the key in the `jiraIssueFields` module. app-key can also be found in the app listing in the Atlassian Universal Plugin Manager. run [Get fields](#api-rest-api-3-field-get) and in the field details the value is returned in `key`. For example, `"key": "teams-add-on__team-issue-field"`		x
Body	Any	Content to use	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Streaming Strategy	Repeatable In Memory Stream Repeatable File Store Stream non-repeatable-stream	Configures how Mule processes streams. Repeatable streams are the default behavior.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for requests to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

Field Key

String

The field key is specified in the following format: $(app-key)_\_$(field-key). For example, example-add-on\_\_example-issue-field. To determine the fieldKey value, do one of the following:

Open the app’s plugin descriptor, then app-key is the key at the top and field-key is the key in the jiraIssueFields module. app-key can also be found in the app listing in the Atlassian Universal Plugin Manager.
run [Get fields](#api-rest-api-3-field-get) and in the field details the value is returned in key. For example, "key": "teams-add-on__team-issue-field"

Body

Any

Content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for requests to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-14)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-14)For Configurations - [Configurations](#Config) ### [](#throws-14)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3Filter)Create Filter `` Creates a filter. The filter is shared according to the \[default share scope\](#api-rest-api-3-filter-post). The filter is not selected as a favorite. **Permissions required:** Permission to access Jira. This operation makes an HTTP POST request to the /rest/api/3/filter endpoint. ### [](#parameters-16)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
expand	String	Use `expand` to include additional information about a filter in the response. This parameter accepts a comma-separated list. Expand options include: `sharedUsers` Returns the users that the filter is shared with. This includes users that can browse projects that the filter is shared with. If you don’t specify `sharedUsers`, then the `sharedUsers` object is returned but it doesn’t list any users. The list of users returned is limited to 1000, to access additional users append `[start-index:end-index]` to the expand request. For example, to access the next 1000 users, use `?expand=sharedUsers[1001:2000]`. `subscriptions` Returns the users that are subscribed to the filter. If you don’t specify `subscriptions`, the `subscriptions` object is returned but it doesn’t list any subscriptions. The list of subscriptions returned is limited to 1000, to access additional subscriptions append `[start-index:end-index]` to the expand request. For example, to access the next 1000 subscriptions, use `?expand=subscriptions[1001:2000]`.
Body	Any	the content to use	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Streaming Strategy	Repeatable In Memory Stream Repeatable File Store Stream non-repeatable-stream	Configures how Mule processes streams. Repeatable streams are the default behavior.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

expand

String

Use expand to include additional information about a filter in the response. This parameter accepts a comma-separated list. Expand options include:

sharedUsers Returns the users that the filter is shared with. This includes users that can browse projects that the filter is shared with. If you don’t specify sharedUsers, then the sharedUsers object is returned but it doesn’t list any users. The list of users returned is limited to 1000, to access additional users append [start-index:end-index] to the expand request. For example, to access the next 1000 users, use ?expand=sharedUsers[1001:2000].
subscriptions Returns the users that are subscribed to the filter. If you don’t specify subscriptions, the subscriptions object is returned but it doesn’t list any subscriptions. The list of subscriptions returned is limited to 1000, to access additional subscriptions append [start-index:end-index] to the expand request. For example, to access the next 1000 subscriptions, use ?expand=subscriptions[1001:2000].

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-15)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-15)For Configurations - [Configurations](#Config) ### [](#throws-15)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3FilterPermissionById)Add Share Permission `` Add a share permissions to a filter. If you add a global share permission (one for all logged-in users or the public) it will overwrite all share permissions for the filter. Be aware that this operation uses different objects for updating share permissions compared to \[Update filter\](#api-rest-api-3-filter-id-put). **Permissions required:** **Share dashboards and filters** [global permission](https://confluence.atlassian.com/x/x4dKLg) and the user must own the filter. This operation makes an HTTP POST request to the /rest/api/3/filter/{id}/permission endpoint. ### [](#parameters-17)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
id	Number	The ID of the filter.		x
Body	Any	the content to use	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Streaming Strategy	Repeatable In Memory Stream Repeatable File Store Stream non-repeatable-stream	Configures how Mule processes streams. Repeatable streams are the default behavior.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

Number

The ID of the filter.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-16)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-16)For Configurations - [Configurations](#Config) ### [](#throws-16)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3Group)Create Group `` Creates a group. **Permissions required:** Site administration (that is, member of the **site-admin** \[group\](https://docs.mulesoft.com/jira-connector/latest/[https://support.atlassian.com/user-management/docs/manage-groups/](https://support.atlassian.com/user-management/docs/manage-groups/)). This operation makes an HTTP POST request to the /rest/api/3/group endpoint. ### [](#parameters-18)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
Body	Any	the content to use	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Streaming Strategy	Repeatable In Memory Stream Repeatable File Store Stream non-repeatable-stream	Configures how Mule processes streams. Repeatable streams are the default behavior.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-17)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-17)For Configurations - [Configurations](#Config) ### [](#throws-17)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3GroupUser)Add User To Group `` Adds a user to a group. **Permissions required:** Site administration (that is, member of the **site-admin** \[group\](https://docs.mulesoft.com/jira-connector/latest/[https://support.atlassian.com/user-management/docs/manage-groups/](https://support.atlassian.com/user-management/docs/manage-groups/)). This operation makes an HTTP POST request to the /rest/api/3/group/user endpoint. ### [](#parameters-19)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
groupname	String	The name of the group (case sensitive).		x
Body	Any	the content to use	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Streaming Strategy	Repeatable In Memory Stream Repeatable File Store Stream non-repeatable-stream	Configures how Mule processes streams. Repeatable streams are the default behavior.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

groupname

String

The name of the group (case sensitive).

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-18)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-18)For Configurations - [Configurations](#Config) ### [](#throws-18)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3Issue)Create Issue `` Creates an issue or, where the option to create subtasks is enabled in Jira, a subtask. A transition may be applied, to move the issue or subtask to a workflow step other than the default start step, and issue properties set. The content of the issue or subtask is defined using `update` and `fields`. The fields that can be set in the issue or subtask are determined using the \[ Get create issue metadata\](#api-rest-api-3-issue-createmeta-get). These are the same fields that appear on the issue’s create screen. Note that the `description`, `environment`, and any `textarea` type custom fields (multi-line text fields) take Atlassian Document Format content. Single line custom fields (`textfield`) accept a string and don’t handle Atlassian Document Format content. Creating a subtask differs from creating an issue as follows: - `issueType` must be set to a subtask issue type (use \[ Get create issue metadata\](#api-rest-api-3-issue-createmeta-get) to find subtask issue types). - `parent` must contain the ID or key of the parent issue. In a next-gen project any issue may be made a child providing that the parent and child are members of the same project. In a classic project the parent field is only valid for subtasks. **Permissions required:** **Browse projects** and **Create issues** \[project permissions\](https://docs.mulesoft.com/jira-connector/latest/[https://confluence.atlassian.com/x/yodKLg](https://confluence.atlassian.com/x/yodKLg)) for the project in which the issue or subtask is created. This operation makes an HTTP POST request to the /rest/api/3/issue endpoint. ### [](#parameters-20)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
Update History	Boolean	Whether the project in which the issue is created is added to the user’s Recently viewed project list, as shown under Projects in Jira.	false
Body	Any	the content to use	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Streaming Strategy	Repeatable In Memory Stream Repeatable File Store Stream non-repeatable-stream	Configures how Mule processes streams. Repeatable streams are the default behavior.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

Update History

Boolean

Whether the project in which the issue is created is added to the user’s Recently viewed project list, as shown under Projects in Jira.

false

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-19)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-19)For Configurations - [Configurations](#Config) ### [](#throws-19)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3IssueAttachmentsByIssueIdOrKey)Add Attachment `` Adds one or more attachments to an issue. Attachments are posted as multipart/form-data [RFC 1867](https://www.ietf.org/rfc/rfc1867.txt). Note that: - The request must have a `X-Atlassian-Token: no-check` header, if not it is blocked. - The name of the multipart/form-data parameter that contains the attachments must be `file`. The following example uploads a file called **myfile.txt** to the issue **TEST-123**: `curl -D- -u admin:admin -X POST -H "X-Atlassian-Token: no-check" -F "file=@myfile.txt" [https://your-domain.atlassian.net/rest/api/3/issue/TEST-123/attachments](https://your-domain.atlassian.net/rest/api/3/issue/TEST-123/attachments)` Tip: Use a client library. Many client libraries have classes for handling multipart POST operations. For example, in Java, the Apache HTTP Components library provides a `MultiPartEntity` class for multipart POST operations. This operation can be accessed anonymously. **Permissions required:** - **Browse Projects** and **Create attachments** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP POST request to the /rest/api/3/issue/{issueIdOrKey}/attachments endpoint. ### [](#parameters-21)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
Issue Id Or Key	String	The ID or key of the issue that attachments are added to.		x
File Name	String	File name of the uploaded attachment.		x
Body	String	the content to use	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Streaming Strategy	Repeatable In Memory Stream Repeatable File Store Stream non-repeatable-stream	Configures how Mule processes streams. Repeatable streams are the default behavior.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue that attachments are added to.

File Name

String

File name of the uploaded attachment.

Body

String

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-20)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-20)For Configurations - [Configurations](#Config) ### [](#throws-20)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3IssueBulk)Create Issues `` Creates issues and, where the option to create subtasks is enabled in Jira, subtasks. Transitions may be applied, to move the issues or subtasks to a workflow step other than the default start step, and issue properties set. The content of each issue or subtask is defined using `update` and `fields`. The fields that can be set in the issue or subtask are determined using the \[ Get create issue metadata\](#api-rest-api-3-issue-createmeta-get). These are the same fields that appear on the issues' create screens. Note that the `description`, `environment`, and any `textarea` type custom fields (multi-line text fields) take Atlassian Document Format content. Single line custom fields (`textfield`) accept a string and don’t handle Atlassian Document Format content. Creating a subtask differs from creating an issue as follows: - `issueType` must be set to a subtask issue type (use \[ Get create issue metadata\](#api-rest-api-3-issue-createmeta-get) to find subtask issue types). - `parent` the must contain the ID or key of the parent issue. **Permissions required:** **Browse projects** and **Create issues** [project permissions](https://confluence.atlassian.com/x/yodKLg) for the project in which each issue or subtask is created. This operation makes an HTTP POST request to the /rest/api/3/issue/bulk endpoint. ### [](#parameters-22)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
Body	Any	the content to use	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Streaming Strategy	Repeatable In Memory Stream Repeatable File Store Stream non-repeatable-stream	Configures how Mule processes streams. Repeatable streams are the default behavior.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-21)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-21)For Configurations - [Configurations](#Config) ### [](#throws-21)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3IssueCommentByIssueIdOrKey)Add Comment `` Adds a comment to an issue. This operation can be accessed anonymously. **Permissions required:** - **Browse projects** and **Add comments** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue containing the comment is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP POST request to the /rest/api/3/issue/{issueIdOrKey}/comment endpoint. ### [](#parameters-23)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
Issue Id Or Key	String	The ID or key of the issue.		x
expand	String	Use `expand` to include additional information about comments in the response. This parameter accepts `renderedBody`, which returns the comment body rendered in HTML.
Body	Any	the content to use	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Streaming Strategy	Repeatable In Memory Stream Repeatable File Store Stream non-repeatable-stream	Configures how Mule processes streams. Repeatable streams are the default behavior.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

expand

String

Use expand to include additional information about comments in the response. This parameter accepts renderedBody, which returns the comment body rendered in HTML.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-22)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-22)For Configurations - [Configurations](#Config) ### [](#throws-22)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3IssueLink)Link Issues `` Creates a link between two issues. Use this operation to indicate a relationship between two issues and optionally add a comment to the from (outward) issue. To use this resource the site must have [Issue Linking](https://confluence.atlassian.com/x/yoXKM) enabled. This resource returns nothing on the creation of an issue link. To obtain the ID of the issue link, use `[linked issue key](https://your-domain.atlassian.net/rest/api/3/issue/)?fields=issuelinks`. If the link request duplicates a link, the response indicates that the issue link was created. If the request included a comment, the comment is added. This operation can be accessed anonymously. **Permissions required:** - **Browse project** [project permission](https://confluence.atlassian.com/x/yodKLg) for all the projects containing the issues to be linked, - **Link issues** [project permission](https://confluence.atlassian.com/x/yodKLg) on the project containing the from (outward) issue, - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. - If the comment has visibility restrictions, belongs to the group or has the role visibility is restricted to. This operation makes an HTTP POST request to the /rest/api/3/issueLink endpoint. ### [](#parameters-24)Parameters

Name Type Description Default Value Required

Name	Type	Description	Default Value	Required
Configuration	String	The name of the configuration to use.		x
Body	Any	the content to use	#[payload]
Config Ref	ConfigurationProvider	Name of the configuration to use to execute this component.
Custom Query Parameters	Object
Custom Headers	Object
Response Timeout	Number	The timeout for request to the remote service.
Response Timeout Unit	Enumeration, one of: NANOSECONDS MICROSECONDS MILLISECONDS SECONDS MINUTES HOURS DAYS	Time unit that qualifies the Response Timeout.
Streaming Type	Enumeration, one of: AUTO ALWAYS NEVER	Defines whether to send the request using streaming. Setting the value to `AUTO` automatically defines the best strategy based on the request content.
Target Variable	String	Name of the variable that stores the operation’s output.
Target Value	String	Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.	#[payload]
Reconnection Strategy	Reconnect Reconnect Forever	A retry strategy in case of connectivity errors

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-23)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-23)For Configurations - [Configurations](#Config) ### [](#throws-23)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3IssueLinkType)Create Issue Link Type `` Creates an issue link type. Use this operation to create descriptions of the reasons why issues are linked. The issue link type consists of a name and descriptions for a link’s inward and outward relationships. To use this operation, the site must have [issue linking](https://confluence.atlassian.com/x/yoXKM) enabled. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP POST request to the /rest/api/3/issueLinkType endpoint. ### [](#parameters-25)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-24)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-24)For Configurations - [Configurations](#Config) ### [](#throws-24)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3IssueNotifyByIssueIdOrKey)Notify `` Creates an email notification for an issue and adds it to the mail queue. **Permissions required:** - **Browse Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP POST request to the /rest/api/3/issue/{issueIdOrKey}/notify endpoint. ### [](#parameters-26)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

ID or key of the issue that the notification is sent for.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-25)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-25)For Configurations - [Configurations](#Config) ### [](#throws-25)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3IssueProperties)Bulk Set Issues Properties `` Sets the values of entity properties on issues. It can set up to 10 entity properties on up to 10,000 issues. The value of the request body must be a [valid](https://datatracker.ietf.org/doc/html/rfc4627), non-empty JSON. The maximum length of single issue property value is 32768 characters. This operation can be accessed anonymously. This operation is: - transactional, either all properties are updated in all eligible issues or, when errors occur, no properties are updated. - \[asynchronous\](#async). Follow the `location` link in the response to determine the status of the task and use \[Get task\](#api-rest-api-3-task-taskId-get) to obtain subsequent updates. **Permissions required:** - **Browse projects** and **Edit issues** [project permissions](https://confluence.atlassian.com/x/yodKLg) for the project containing the issue. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP POST request to the /rest/api/3/issue/properties endpoint. ### [](#parameters-27)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-26)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-26)For Configurations - [Configurations](#Config) ### [](#throws-26)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3IssueRemotelinkByIssueIdOrKey)Create Or Update Remote Issue Link `` Creates or updates a remote issue link for an issue. If a `globalId` is provided and a remote issue link with that global ID is found it is updated. Any fields without values in the request are set to null. Otherwise, the remote issue link is created. This operation requires [issue linking to be active](https://confluence.atlassian.com/x/yoXKM). This operation can be accessed anonymously. **Permissions required:** - **Browse projects** and **Link issues** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP POST request to the /rest/api/3/issue/{issueIdOrKey}/remotelink endpoint. ### [](#parameters-28)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-27)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-27)For Configurations - [Configurations](#Config) ### [](#throws-27)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3IssueTransitionsByIssueIdOrKey)Do Transition `` Performs an issue transition and, if the transition has a screen, updates the fields from the transition screen. sortByCategory To update the fields on the transition screen, specify the fields in the `fields` or `update` parameters in the request body. Get details about the fields using \[Get transitions\](#api-rest-api-3-issue-issueIdOrKey-transitions-get) with the `transitions.fields` expand. This operation can be accessed anonymously. **Permissions required:** - **Browse projects** and **Transition issues** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP POST request to the /rest/api/3/issue/{issueIdOrKey}/transitions endpoint. ### [](#parameters-29)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-28)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-28)For Configurations - [Configurations](#Config) ### [](#throws-28)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3IssueVotesByIssueIdOrKey)Add Vote `` Adds the user’s vote to an issue. This is the equivalent of the user clicking **Vote** on an issue in Jira. This operation requires the **Allow users to vote on issues** option to be **ON**. This option is set in General configuration for Jira. See [Configuring Jira application options](https://confluence.atlassian.com/x/uYXKM) for details. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP POST request to the /rest/api/3/issue/{issueIdOrKey}/votes endpoint. ### [](#parameters-30)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-29)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-29)For Configurations - [Configurations](#Config) ### [](#throws-29)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3IssueWatchersByIssueIdOrKey)Add Watcher `` Adds a user as a watcher of an issue by passing the account ID of the user. For example, `"123456789"`. If no user is specified the calling user is added. This operation requires the **Allow users to watch issues** option to be **ON**. This option is set in General configuration for Jira. See [Configuring Jira application options](https://confluence.atlassian.com/x/uYXKM) for details. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. - To add users other than themselves to the watchlist, **Manage watcher list** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. This operation makes an HTTP POST request to the /rest/api/3/issue/{issueIdOrKey}/watchers endpoint. ### [](#parameters-31)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Body

String

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-30)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-30)For Configurations - [Configurations](#Config) ### [](#throws-30)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3IssueWorklogByIssueIdOrKey)Add Worklog `` Adds a worklog to an issue. Time tracking must be enabled in Jira, otherwise this operation returns an error. For more information, see [Configuring time tracking](https://confluence.atlassian.com/x/qoXKM). This operation can be accessed anonymously. **Permissions required:** - **Browse projects** and **Work on issues** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP POST request to the /rest/api/3/issue/{issueIdOrKey}/worklog endpoint. ### [](#parameters-32)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key the issue.

Notify Users

Boolean

Whether users watching the issue are notified by email.

true

Adjust Estimate

Enumeration, one of:

NEW
LEAVE
MANUAL
AUTO

Defines how to update the issue’s time estimate, the options are:

new Sets the estimate to a specific value, defined in newEstimate.
leave Leaves the estimate unchanged.
manual Reduces the estimate by amount specified in reduceBy.
auto Reduces the estimate by the value of timeSpent in the worklog.

AUTO

New Estimate

String

The value to set as the issue’s remaining time estimate, as days (#d), hours (\#h), or minutes (\#m or \#). For example, 2d. Required when adjustEstimate is new.

Reduce By

String

The amount to reduce the issue’s remaining estimate by, as days (\#d), hours (\#h), or minutes (\#m). For example, 2d. Required when adjustEstimate is manual.

expand

String

Use expand to include additional information about work logs in the response. This parameter accepts properties, which returns worklog properties.

Override Editable Flag

Boolean

Whether the worklog entry should be added to the issue even if the issue is not editable, because jira.issue.editable set to false or missing. For example, the issue is closed. Only connect app users with admin scope permission can use this flag.

false

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-31)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-31)For Configurations - [Configurations](#Config) ### [](#throws-31)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3Issuetype)Create Issue Type `` Creates an issue type and adds it to the default issue type scheme. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP POST request to the /rest/api/3/issuetype endpoint. ### [](#parameters-33)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-32)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-32)For Configurations - [Configurations](#Config) ### [](#throws-32)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3IssuetypeAvatar2ById)Create Issue Type Avatar `` Loads an avatar for the issue type. Specify the avatar’s local file location in the body of the request. Also, include the following headers: - `X-Atlassian-Token: no-check` To prevent XSRF protection blocking the request, for more information see \[Special Headers\](#special-request-headers). - `Content-Type: image/image type` Valid image types are JPEG, GIF, or PNG. For example: `curl --request POST \ --user [email@example.com](mailto:email@example.com): \ --header 'X-Atlassian-Token: no-check' \ --header 'Content-Type: image/< image_type>' \ --data-binary "<@/path/to/file/with/your/avatar>" \ --url 'https://your-domain.atlassian.net/rest/api/3/issuetype/{issueTypeId}'This` The avatar is cropped to a square. If no crop parameters are specified, the square originates at the top left of the image. The length of the square’s sides is set to the smaller of the height or width of the image. The cropped image is then used to create avatars of 16x16, 24x24, 32x32, and 48x48 in size. After creating the avatar, use \[Update issue type\](#api-rest-api-3-issuetype-id-put) to set it as the issue type’s displayed avatar. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP POST request to the /rest/api/3/issuetype/{id}/avatar2 endpoint. ### [](#parameters-34)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the issue type.

Number

The X coordinate of the top-left corner of the crop region.

Number

The Y coordinate of the top-left corner of the crop region.

size

Number

The length of each side of the crop region.

Body

Binary

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-33)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-33)For Configurations - [Configurations](#Config) ### [](#throws-33)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3Issuetypescheme)Create Issue Type Scheme `` Creates an issue type scheme. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP POST request to the /rest/api/3/issuetypescheme endpoint. ### [](#parameters-35)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-34)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-34)For Configurations - [Configurations](#Config) ### [](#throws-34)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3Issuetypescreenscheme)Create Issue Type Screen Scheme `` Creates an issue type screen scheme. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP POST request to the /rest/api/3/issuetypescreenscheme endpoint. ### [](#parameters-36)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-35)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-35)For Configurations - [Configurations](#Config) ### [](#throws-35)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3IssuetypescreenschemeMappingRemoveByIssueTypeScreenSchemeId)Remove Mappings From Issue Type Screen Scheme `` Removes issue type to screen scheme mappings from an issue type screen scheme. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP POST request to the /rest/api/3/issuetypescreenscheme/{issueTypeScreenSchemeId}/mapping/remove endpoint. ### [](#parameters-37)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Type Screen Scheme Id

String

The ID of the issue type screen scheme.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-36)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-36)For Configurations - [Configurations](#Config) ### [](#throws-36)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3JqlMatch)Match Issues `` Checks whether one or more issues will be returned by one or more JQL queries. **Permissions required:** None, however, issues are only matched against JQL queries where the user has: - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP POST request to the /rest/api/3/jql/match endpoint. ### [](#parameters-38)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-37)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-37)For Configurations - [Configurations](#Config) ### [](#throws-37)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3JqlParse)Parse Jql Queries `` Parses and validates JQL queries. Validation is performed in context of the current user. This operation can be accessed anonymously. **Permissions required:** None. This operation makes an HTTP POST request to the /rest/api/3/jql/parse endpoint. ### [](#parameters-39)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

validation

Enumeration, one of:

STRICT
WARN
NONE

How to validate the JQL query and treat the validation results. Validation options include: * strict Returns all errors. If validation fails, the query structure is not returned. * warn Returns all errors. If validation fails but the JQL query is correctly formed, the query structure is returned. * none No validation is performed. If JQL query is correctly formed, the query structure is returned.

STRICT

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-38)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-38)For Configurations - [Configurations](#Config) ### [](#throws-38)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3JqlPdcleaner)Migrate Queries `` Converts one or more JQL queries with user identifiers (username or user key) to equivalent JQL queries with account IDs. You might want to use this operation if your system stores JQL queries and you want to make them GDPR-compliant. For more information about GDPR-related changes, see the [migration guide](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/). **Permissions required:** Permission to access Jira. This operation makes an HTTP POST request to the /rest/api/3/jql/pdcleaner endpoint. ### [](#parameters-40)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-39)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-39)For Configurations - [Configurations](#Config) ### [](#throws-39)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3PermissionsCheck)Get Bulk Permissions `` Returns: - For a list of global permissions, the global permissions granted to a user. - For a list of project permissions and lists of projects and issues, for each project permission a list of the projects and issues a user can access or manipulate. If no account ID is provided, the operation returns details for the logged in user. Note that invalid project and issue IDs are ignored. - A maximum of 1000 projects and 1000 issues can be checked. - globalPermissions, projectPermissions, projects, permissions, issues having null values in the input are ignored. - globalPermissions, permissions having blank string values in the input are ignored This operation can be accessed anonymously. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) to check the permissions for other users, otherwise none. However, Connect apps can make a call from the app server to the product to obtain permission details for any user, without admin permission. This Connect app ability doesn’t apply to calls made using AP.request() in a browser. This operation makes an HTTP POST request to the /rest/api/3/permissions/check endpoint. ### [](#parameters-41)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-40)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-40)For Configurations - [Configurations](#Config) ### [](#throws-40)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3PermissionsProject)Get Permitted Projects `` Returns all the projects where the user is granted a list of project permissions. This operation can be accessed anonymously. **Permissions required:** None. This operation makes an HTTP POST request to the /rest/api/3/permissions/project endpoint. ### [](#parameters-42)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors.

### [](#output-41)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-41)For Configurations - [Configurations](#Config) ### [](#throws-41)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3Permissionscheme)Create Permission Scheme `` Creates a new permission scheme. You can create a permission scheme with or without defining a set of permission grants. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP POST request to the /rest/api/3/permissionscheme endpoint. ### [](#parameters-43)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

expand

String

Use expand to include additional information in the response. This parameter accepts a comma-separated list. Note that permissions are always included when you specify any value. Expand options include:

all Returns all expandable information.
field Returns information about the custom field granted the permission.
group Returns information about the group that is granted the permission.
permissions Returns all permission grants for each permission scheme.
projectRole Returns information about the project role granted the permission.
user Returns information about the user who is granted the permission.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-42)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-42)For Configurations - [Configurations](#Config) ### [](#throws-42)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3PermissionschemePermissionBySchemeId)Create Permission Grant `` Creates a permission grant in a permission scheme. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP POST request to the /rest/api/3/permissionscheme/{schemeId}/permission endpoint. ### [](#parameters-44)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Scheme Id

Number

The ID of the permission scheme in which to create a new permission grant.

expand

String

Use expand to include additional information in the response. This parameter accepts a comma-separated list. Note that permissions are always included when you specify any value. Expand options include:

permissions Returns all permission grants for each permission scheme.
user Returns information about the user who is granted the permission.
group Returns information about the group that is granted the permission.
projectRole Returns information about the project role granted the permission.
field Returns information about the custom field granted the permission.
all Returns all expandable information.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-43)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-43)For Configurations - [Configurations](#Config) ### [](#throws-43)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3Project)Create Project `` Creates a project based on a project type template, as shown in the following table:

Project Type Key Project Template Key

business

com.atlassian.jira-core-project-templates:jira-core-simplified-content-management, com.atlassian.jira-core-project-templates:jira-core-simplified-document-approval, com.atlassian.jira-core-project-templates:jira-core-simplified-lead-tracking, com.atlassian.jira-core-project-templates:jira-core-simplified-process-control, com.atlassian.jira-core-project-templates:jira-core-simplified-procurement, com.atlassian.jira-core-project-templates:jira-core-simplified-project-management, com.atlassian.jira-core-project-templates:jira-core-simplified-recruitment, com.atlassian.jira-core-project-templates:jira-core-simplified-task-tracking

service_desk

com.atlassian.servicedesk:simplified-it-service-desk, com.atlassian.servicedesk:simplified-internal-service-desk, com.atlassian.servicedesk:simplified-external-service-desk

software

com.pyxis.greenhopper.jira:gh-simplified-agility-kanban, com.pyxis.greenhopper.jira:gh-simplified-agility-scrum, com.pyxis.greenhopper.jira:gh-simplified-basic, com.pyxis.greenhopper.jira:gh-simplified-kanban-classic, com.pyxis.greenhopper.jira:gh-simplified-scrum-classic

The project types are available according to the installed Jira features as follows: - Jira Core, the default, enables `business` projects. - Jira Service Management enables `service_desk` projects. - Jira Software enables `software` projects. To determine which features are installed, go to **Jira settings** > **Apps** > **Manage apps** and review the System Apps list. To add Jira Software or Jira Service Management into a JIRA instance, use **Jira settings** > **Apps** > **Finding new apps**. For more information, see [Managing add-ons](https://confluence.atlassian.com/x/S31NLg). **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP POST request to the /rest/api/3/project endpoint. ### [](#parameters-45)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-44)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-44)For Configurations - [Configurations](#Config) ### [](#throws-44)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3ProjectArchiveByProjectIdOrKey)Archive Project `` Archives a project. Archived projects cannot be deleted. To delete an archived project, restore the project and then delete it. To restore a project, use the Jira UI. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP POST request to the /rest/api/3/project/{projectIdOrKey}/archive endpoint. ### [](#parameters-46)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or project key (case sensitive).

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-45)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-45)For Configurations - [Configurations](#Config) ### [](#throws-45)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3ProjectAvatar2ByProjectIdOrKey)Create Project Avatar `` Loads an avatar for a project. Specify the avatar’s local file location in the body of the request. Also, include the following headers: - `X-Atlassian-Token: no-check` To prevent XSRF protection blocking the request, for more information see \[Special Headers\](#special-request-headers). - `Content-Type: image/image type` Valid image types are JPEG, GIF, or PNG. **Example** ``curl --request POST ` `--user [email@example.com](mailto:email@example.com): ` `--header 'X-Atlassian-Token: no-check' ` `--header 'Content-Type: image/< image_type>' ` `--data-binary "<@/path/to/file/with/your/avatar>" ` `--url 'https://your-domain.atlassian.net/rest/api/3/project/{projectIdOrKey}/avatar2'`` The avatar is cropped to a square. If no crop parameters are specified, the square originates at the top left of the image. The length of the square’s sides is set to the smaller of the height or width of the image. The cropped image is then used to create avatars of 16x16, 24x24, 32x32, and 48x48 in size. After creating the avatar use \[Set project avatar\](#api-rest-api-3-project-projectIdOrKey-avatar-put) to set it as the project’s displayed avatar. **Permissions required:** **Administer projects** [Project permission](https://confluence.atlassian.com/x/yodKLg) This operation makes an HTTP POST request to the /rest/api/3/project/{projectIdOrKey}/avatar2 endpoint. ### [](#parameters-47)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The ID or (case-sensitive) key of the project.

Number

The X coordinate of the top-left corner of the crop region.

Number

The Y coordinate of the top-left corner of the crop region.

size

Number

The length of each side of the crop region.

Body

Binary

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-46)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-46)For Configurations - [Configurations](#Config) ### [](#throws-46)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3ProjectCategory)Create Project Category `` Creates a project category. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP POST request to the /rest/api/3/projectCategory endpoint. ### [](#parameters-48)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-47)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-47)For Configurations - [Configurations](#Config) ### [](#throws-47)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3ProjectDeleteByProjectIdOrKey)Delete Project Asynchronously `` Deletes a project asynchronously. This operation is: - Transactional, that is, if part of the delete fails the project is not deleted. - Asynchronous Follow the `location` link in the response to determine the status of the task and use \[Get task\](#api-rest-api-3-task-taskId-get) to obtain subsequent updates. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP POST request to the /rest/api/3/project/{projectIdOrKey}/delete endpoint. ### [](#parameters-49)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or project key (case sensitive).

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-48)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-48)For Configurations - [Configurations](#Config) ### [](#throws-48)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3ProjectRestoreByProjectIdOrKey)restore `` Restores a project from the Jira recycle bin. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP POST request to the /rest/api/3/project/{projectIdOrKey}/restore endpoint. ### [](#parameters-50)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or project key (case sensitive).

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-49)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-49)For Configurations - [Configurations](#Config) ### [](#throws-49)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3ProjectRoleByProjectIdOrKeyId)Add Actor Users `` Adds actors to a project role for the project. To replace all actors for the project, use \[Set actors for project role\](#api-rest-api-3-project-projectIdOrKey-role-id-put). This operation can be accessed anonymously. **Permissions required:** **Administer Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project or **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP POST request to the /rest/api/3/project/{projectIdOrKey}/role/{id} endpoint. ### [](#parameters-51)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or project key (case sensitive).

Number

The ID of the project role. Use [Get all project roles](#api-rest-api-3-role-get) to get a list of project role IDs.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-50)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-50)For Configurations - [Configurations](#Config) ### [](#throws-50)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3Role)Create Project Role `` Creates a new project role with no \[default actors\](#api-rest-api-3-resolution-get). You can use the \[Add default actors to project role\](#api-rest-api-3-role-id-actors-post) operation to add default actors to the project role after creating it.

Although a new project role is available to all projects upon creation, any default actors that are associated with the project role are not added to projects that existed prior to the role being created.

**Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP POST request to the /rest/api/3/role endpoint. ### [](#parameters-52)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-51)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-51)For Configurations - [Configurations](#Config) ### [](#throws-51)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3RoleActorsById)Add Project Role Actors To Role `` Adds \[default actors\](#api-rest-api-3-resolution-get) to a role. You can add groups or users, but you cannot add groups and users in the same request. Changing a project role’s default actors does not affect project role members for projects already created. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP POST request to the /rest/api/3/role/{id}/actors endpoint. ### [](#parameters-53)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the project role. Use [Get all project roles](#api-rest-api-3-role-get) to get a list of project role IDs.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-52)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-52)For Configurations - [Configurations](#Config) ### [](#throws-52)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3RoleById)Partial Update Project Role `` Updates either the project role’s name or its description. You cannot update both the name and description at the same time using this operation. If you send a request with a name and a description only the name is updated. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP POST request to the /rest/api/3/role/{id} endpoint. ### [](#parameters-54)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the project role. Use [Get all project roles](#api-rest-api-3-role-get) to get a list of project role IDs.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-53)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-53)For Configurations - [Configurations](#Config) ### [](#throws-53)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3Screens)Create Screen `` Creates a screen with a default field tab. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP POST request to the /rest/api/3/screens endpoint. ### [](#parameters-55)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-54)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-54)For Configurations - [Configurations](#Config) ### [](#throws-54)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3ScreensAddToDefaultByFieldId)Add Field To Default Screen `` Adds a field to the default tab of the default screen. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP POST request to the /rest/api/3/screens/addToDefault/{fieldId} endpoint. ### [](#parameters-56)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Id

String

The ID of the field.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-55)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-55)For Configurations - [Configurations](#Config) ### [](#throws-55)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3ScreensTabsByScreenId)Add Screen Tab `` Creates a tab for a screen. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP POST request to the /rest/api/3/screens/{screenId}/tabs endpoint. ### [](#parameters-57)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Screen Id

Number

The ID of the screen.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-56)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-56)For Configurations - [Configurations](#Config) ### [](#throws-56)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3ScreensTabsFieldsByScreenIdTabId)Add Screen Tab Field `` Adds a field to a screen tab. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP POST request to the /rest/api/3/screens/{screenId}/tabs/{tabId}/fields endpoint. ### [](#parameters-58)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Screen Id

Number

The ID of the screen.

Tab Id

Number

The ID of the screen tab.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-57)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-57)For Configurations - [Configurations](#Config) ### [](#throws-57)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3ScreensTabsFieldsMoveByScreenIdTabIdId)Move Screen Tab Field `` Moves a screen tab field. If `after` and `position` are provided in the request, `position` is ignored. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP POST request to the /rest/api/3/screens/{screenId}/tabs/{tabId}/fields/{id}/move endpoint. ### [](#parameters-59)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Screen Id

Number

The ID of the screen.

Tab Id

Number

The ID of the screen tab.

String

The ID of the field.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-58)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-58)For Configurations - [Configurations](#Config) ### [](#throws-58)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3ScreensTabsMoveByScreenIdTabIdPos)Move Screen Tab `` Moves a screen tab. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP POST request to the /rest/api/3/screens/{screenId}/tabs/{tabId}/move/{pos} endpoint. ### [](#parameters-60)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Screen Id

Number

The ID of the screen.

Tab Id

Number

The ID of the screen tab.

pos

Number

The position of tab. The base index is 0.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-59)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-59)For Configurations - [Configurations](#Config) ### [](#throws-59)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3Screenscheme)Create Screen Scheme `` Creates a screen scheme. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP POST request to the /rest/api/3/screenscheme endpoint. ### [](#parameters-61)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-60)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-60)For Configurations - [Configurations](#Config) ### [](#throws-60)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3Search)Search For Issues Using Jql Post `` Searches for issues using [JQL](https://support.atlassian.com/jira-software-cloud/docs/what-is-advanced-search-in-jira-cloud/). There is a \[GET\](#api-rest-api-3-search-get) version of this resource that can be used for smaller JQL query expressions. This operation can be accessed anonymously. **Permissions required:** Issues are included in the response where the user has: - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project containing the issue. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP POST request to the /rest/api/3/search/jql endpoint. ### [](#parameters-62)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-61)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-61)For Configurations - [Configurations](#Config) ### [](#throws-61)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3TaskCancelByTaskId)Cancel Task `` Cancels a task. **Permissions required:** Either of: - **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) - Creator of the task This operation makes an HTTP POST request to the /rest/api/3/task/{taskId}/cancel endpoint. ### [](#parameters-63)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Task Id

String

The ID of the task.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-62)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-62)For Configurations - [Configurations](#Config) ### [](#throws-62)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3UniversalAvatarTypeOwnerByTypeEntityId)Store Avatar `` Loads a custom avatar for a project or issue type. Specify the avatar’s local file location in the body of the request. Also, include the following headers: - `X-Atlassian-Token: no-check` To prevent XSRF protection blocking the request, for more information see \[Special Headers\](#special-request-headers). - `Content-Type: image/image type` Valid image types are JPEG, GIF, or PNG. **Example** ``curl --request POST ` `--user [email@example.com](mailto:email@example.com): ` `--header 'X-Atlassian-Token: no-check' ` `--header 'Content-Type: image/< image_type>' ` `--data-binary "<@/path/to/file/with/your/avatar>" ` `--url 'https://your-domain.atlassian.net/rest/api/3/universal_avatar/type/{type}/owner/{entityId}'`` The avatar is cropped to a square. If no crop parameters are specified, the square originates at the top left of the image. The length of the square’s sides is set to the smaller of the height or width of the image. The cropped image is then used to create avatars of 16x16, 24x24, 32x32, and 48x48 in size. After creating the avatar use: - \[Update issue type\](#api-rest-api-3-issuetype-id-put) to set it as the issue type’s displayed avatar. - \[Set project avatar\](#api-rest-api-3-project-projectIdOrKey-avatar-put) to set it as the project’s displayed avatar. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP POST request to the /rest/api/3/universal\_avatar/type/{type}/owner/{entityId} endpoint. ### [](#parameters-64)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

type

Enumeration, one of:

PROJECT
ISSUETYPE

The avatar type.

Entity Id

String

The ID of the item the avatar is associated with.

Number

The X coordinate of the top-left corner of the crop region.

Number

The Y coordinate of the top-left corner of the crop region.

size

Number

The length of each side of the crop region.

Body

Binary

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-63)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-63)For Configurations - [Configurations](#Config) ### [](#throws-63)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3User)Create User `` Creates a user. This resource is retained for legacy compatibility. As soon as a more suitable alternative is available this resource will be deprecated. The option is provided to set or generate a password for the user. When using the option to generate a password, by omitting `password` from the request, include `"notification": "true"` to ensure the user is sent an email advising them that their account is created. This email includes a link for the user to set their password. If the notification isn’t sent for a generated password, the user will need to be sent a reset password request from Jira. If the user exists and has access to Jira, the operation returns a 201 status. If the user exists but does not have access to Jira, the operation returns a 400 status. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP POST request to the /rest/api/3/user endpoint. ### [](#parameters-65)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-64)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-64)For Configurations - [Configurations](#Config) ### [](#throws-64)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3Version)Create Version `` Creates a project version. This operation can be accessed anonymously. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) or **Administer Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project the version is added to. This operation makes an HTTP POST request to the /rest/api/3/version endpoint. ### [](#parameters-66)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-65)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-65)For Configurations - [Configurations](#Config) ### [](#throws-65)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3VersionMoveById)Move Version `` Modifies the version’s sequence within the project, which affects the display order of the versions in Jira. This operation can be accessed anonymously. **Permissions required:** **Browse projects** project permission for the project that contains the version. This operation makes an HTTP POST request to the /rest/api/3/version/{id}/move endpoint. ### [](#parameters-67)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the version to be moved.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-66)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-66)For Configurations - [Configurations](#Config) ### [](#throws-66)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3VersionRemoveAndSwapById)Delete And Replace Version `` Deletes a project version. Alternative versions can be provided to update issues that use the deleted version in `fixVersion`, `affectedVersion`, or any version picker custom fields. If alternatives are not provided, occurrences of `fixVersion`, `affectedVersion`, and any version picker custom field, that contain the deleted version, are cleared. Any replacement version must be in the same project as the version being deleted and cannot be the version being deleted. This operation can be accessed anonymously. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) or **Administer Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that contains the version. This operation makes an HTTP POST request to the /rest/api/3/version/{id}/removeAndSwap endpoint. ### [](#parameters-68)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the version.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-67)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-67)For Configurations - [Configurations](#Config) ### [](#throws-67)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3Webhook)Register Dynamic Webhooks `` Registers webhooks. **Permissions required:** Only [Connect apps](https://developer.atlassian.com/cloud/jira/platform/index/) can use this operation. This operation makes an HTTP POST request to the /rest/api/3/webhook endpoint. ### [](#parameters-69)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-68)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-68)For Configurations - [Configurations](#Config) ### [](#throws-68)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3WorkflowTransitionsPropertiesByTransitionId)Create Workflow Transition Property `` Adds a property to a workflow transition. Transition properties are used to change the behavior of a transition. For more information, see [Transition properties](https://confluence.atlassian.com/x/zIhKLg#Advancedworkflowconfiguration-transitionproperties) and [Workflow properties](https://confluence.atlassian.com/x/JYlKLg). **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP POST request to the /rest/api/3/workflow/transitions/{transitionId}/properties endpoint. ### [](#parameters-70)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Transition Id

Number

The ID of the transition. To get the ID, view the workflow in text mode in the Jira admin settings. The ID is shown next to the transition.

key

String

The key of the property being added, also known as the name of the property. Set this to the same value as the key defined in the request body.

Workflow Name

String

The name of the workflow that the transition belongs to.

Workflow Mode

Enumeration, one of:

LIVE
DRAFT

The workflow status. Set to live for inactive workflows or draft for draft workflows. Active workflows cannot be edited.

LIVE

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-69)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-69)For Configurations - [Configurations](#Config) ### [](#throws-69)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3Workflowscheme)Create Workflow Scheme `` Creates a workflow scheme. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP POST request to the /rest/api/3/workflowscheme endpoint. ### [](#parameters-71)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-70)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-70)For Configurations - [Configurations](#Config) ### [](#throws-70)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3WorkflowschemeCreatedraftById)Create Workflow Scheme Draft From Parent `` Create a draft workflow scheme from an active workflow scheme, by copying the active workflow scheme. Note that an active workflow scheme can only have one draft workflow scheme. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP POST request to the /rest/api/3/workflowscheme/{id}/createdraft endpoint. ### [](#parameters-72)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the active workflow scheme that the draft is created from.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-71)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-71)For Configurations - [Configurations](#Config) ### [](#throws-71)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestApi3WorklogList)Get Worklogs For Ids `` Returns worklog details for a list of worklog IDs. The returned list of worklogs is limited to 1000 items. **Permissions required:** Permission to access Jira, however, worklogs are only returned where either of the following is true: - The worklog is set as **Viewable by All Users**. - The user is a member of a project role or group with permission to view the worklog. This operation makes an HTTP POST request to the /rest/api/3/worklog/list endpoint. ### [](#parameters-73)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

expand

String

Use expand to include additional information about worklogs in the response. This parameter accepts properties that returns the properties of each worklog.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-72)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-72)For Configurations - [Configurations](#Config) ### [](#throws-72)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#CreateRestAtlassianConnect1AppModuleDynamic)Dynamic Modules Resource register Modules post `` Registers a list of modules. **Permissions required:** Only Connect apps can make this request. This operation makes an HTTP POST request to the /rest/atlassian-connect/1/app/module/dynamic endpoint. ### [](#parameters-74)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-73)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-73)For Configurations - [Configurations](#Config) ### [](#throws-73)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3AttachmentById)Remove Attachment `` Deletes an attachment from an issue. This operation can be accessed anonymously. **Permissions required:** For the project holding the issue containing the attachment: - **Delete own attachments** [project permission](https://confluence.atlassian.com/x/yodKLg) to delete an attachment created by the calling user. - **Delete all attachments** [project permission](https://confluence.atlassian.com/x/yodKLg) to delete an attachment created by any user. This operation makes an HTTP DELETE request to the /rest/api/3/attachment/{id} endpoint. ### [](#parameters-75)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the attachment.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-74)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-74)For Configurations - [Configurations](#Config) ### [](#throws-74)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3CommentPropertiesByCommentIdPropertyKey)Delete Comment Property `` Deletes a comment property. **Permissions required:** Either of: - **Edit All Comments** [project permission](https://confluence.atlassian.com/x/yodKLg) to delete a property from any comment. - **Edit Own Comments** [project permission](https://confluence.atlassian.com/x/yodKLg) to delete a property from a comment created by the user. Also, when the visibility of a comment is restricted to a role or group, the user must be a member of that role or group. This operation makes an HTTP DELETE request to the /rest/api/3/comment/{commentId}/properties/{propertyKey} endpoint. ### [](#parameters-76)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Comment Id

String

The ID of the comment.

Property Key

String

The key of the property.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-75)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-75)For Configurations - [Configurations](#Config) ### [](#throws-75)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3ComponentById)Delete Component `` Deletes a component. This operation can be accessed anonymously. **Permissions required:** **Administer projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project containing the component or **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP DELETE request to the /rest/api/3/component/{id} endpoint. ### [](#parameters-77)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the component.

Move Issues To

String

The ID of the component to replace the deleted component. If this value is null no replacement is made.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-76)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-76)For Configurations - [Configurations](#Config) ### [](#throws-76)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3DashboardById)Delete Dashboard `` Deletes a dashboard. **Permissions required:** None The dashboard to be deleted must be owned by the user. This operation makes an HTTP DELETE request to the /rest/api/3/dashboard/{id} endpoint. ### [](#parameters-78)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the dashboard.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-77)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-77)For Configurations - [Configurations](#Config) ### [](#throws-77)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3DashboardItemsPropertiesByDashboardIdItemIdPropertyKey)Delete Dashboard Item Property `` Deletes a dashboard item property. This operation can be accessed anonymously. **Permissions required:** The user must be the owner of the dashboard. Note, users with the **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) are considered owners of the System dashboard. This operation makes an HTTP DELETE request to the /rest/api/3/dashboard/{dashboardId}/items/{itemId}/properties/{propertyKey} endpoint. ### [](#parameters-79)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Dashboard Id

String

The ID of the dashboard.

Item Id

String

The ID of the dashboard item.

Property Key

String

The key of the dashboard item property.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-78)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-78)For Configurations - [Configurations](#Config) ### [](#throws-78)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3FieldContextByFieldIdContextId)Delete Custom Field Context `` Deletes a [custom field context](https://support.atlassian.com/jira-cloud-administration/docs/configure-custom-field-context/). **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/field/{fieldId}/context/{contextId} endpoint. ### [](#parameters-80)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Id

String

The ID of the custom field.

Context Id

Number

The ID of the context.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-79)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-79)For Configurations - [Configurations](#Config) ### [](#throws-79)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3FieldContextOptionByFieldIdContextIdOptionId)Delete Custom Field Option `` Deletes a custom field option. Options with cascading options cannot be deleted without deleting the cascading options first. This operation works for custom field options created in Jira or the operations from this resource. To work with the issue field select list options created for Connect apps use the \[Issue custom field options (apps)\](#api-group-issue-custom-field-options—apps-) operations. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP DELETE request to the /rest/api/3/field/{fieldId}/context/{contextId}/option/{optionId} endpoint. ### [](#parameters-81)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Id

String

The ID of the custom field.

Context Id

Number

The ID of the context from which an option should be deleted.

Option Id

Number

The ID of the option to delete.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-80)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-80)For Configurations - [Configurations](#Config) ### [](#throws-80)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3FieldOptionByFieldKeyOptionId)Delete Issue Field Option `` Deletes an option from a select list issue field. Note that this operation **only works for issue field select list options added by Connect apps**, it cannot be used with issue field select list options created in Jira or using operations from the \[Issue custom field options\](#api-group-Issue-custom-field-options) resource. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). Jira permissions are not required for the app providing the field. This operation makes an HTTP DELETE request to the /rest/api/3/field/{fieldKey}/option/{optionId} endpoint. ### [](#parameters-82)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Key

String

The field key is specified in the following format: $(app-key)_\_$(field-key). For example, example-add-on\_\_example-issue-field. To determine the fieldKey value, do one of the following:

open the app’s plugin descriptor, then app-key is the key at the top and field-key is the key in the jiraIssueFields module. app-key can also be found in the app listing in the Atlassian Universal Plugin Manager.
run [Get fields](#api-rest-api-3-field-get) and in the field details the value is returned in key. For example, "key": "teams-add-on_team-issue-field"

Option Id

Number

The ID of the option to be deleted.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-81)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-81)For Configurations - [Configurations](#Config) ### [](#throws-81)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3FieldOptionIssueByFieldKeyOptionId)Replace Issue Field Option `` Deselects an issue-field select-list option from all issues where it is selected. A different option can be selected to replace the deselected option. The update can also be limited to a smaller set of issues by using a JQL query. This is an \[asynchronous operation\](#async). The response object contains a link to the long-running task. Note that this operation **only works for issue field select list options added by Connect apps**, it cannot be used with issue field select list options created in Jira or using operations from the \[Issue custom field options\](#api-group-Issue-custom-field-options) resource. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). Jira permissions are not required for the app providing the field. This operation makes an HTTP DELETE request to the /rest/api/3/field/{fieldKey}/option/{optionId}/issue endpoint. ### [](#parameters-83)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Key

String

The field key is specified in the following format: $(app-key)_\_$(field-key), for example, example-add-on\_\_example-issue-field.

To determine the fieldKey value, do one of the following:

Open the app’s plugin descriptor, then app-key is the key at the top and field-key is the key in the jiraIssueFields module. app-key can also be found in the app listing in the Atlassian Universal Plugin Manager.
Run [Get fields](#api-rest-api-3-field-get) and in the field details the value is returned in key, for example, "key": "teams-add-on_team-issue-field"

Option Id

Number

The ID of the option to be deselected.

Replace With

Number

The ID of the option that will replace the currently selected option.

jql

String

A JQL query that specifies the issues to be updated. For example, project=10000.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-82)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-82)For Configurations - [Configurations](#Config) ### [](#throws-82)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3FilterById)Delete Filter `` Deletes a filter. **Permissions required:** Permission to access Jira, however filters can only be deleted by the creator of the filter or a user with **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP DELETE request to the /rest/api/3/filter/{id} endpoint. ### [](#parameters-84)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the filter to delete.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-83)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-83)For Configurations - [Configurations](#Config) ### [](#throws-83)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3FilterColumnsById)Reset Columns `` Resets the user’s column configuration for the filter to the default. **Permissions required:** Permission to access Jira, however, columns are only reset for: - filters owned by the user. - filters shared with a group that the user is a member of. - filters shared with a private project that the user has **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for. - filters shared with a public project. - filters shared with the public. This operation makes an HTTP DELETE request to the /rest/api/3/filter/{id}/columns endpoint. ### [](#parameters-85)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the filter.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-84)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-84)For Configurations - [Configurations](#Config) ### [](#throws-84)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3FilterFavouriteById)Delete Favourite For Filter `` Removes a filter as a favorite for the user. Note that this operation only removes filters visible to the user from the user’s favorites list. For example, if the user favorites a public filter that is subsequently made private (and is therefore no longer visible on their favorites list) they cannot remove it from their favorites list. **Permissions required:** Permission to access Jira. This operation makes an HTTP DELETE request to the /rest/api/3/filter/{id}/favourite endpoint. ### [](#parameters-86)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the filter.

expand

String

Use expand to include additional information about filter in the response. This parameter accepts a comma-separated list. Expand options include:

sharedUsers Returns the users that the filter is shared with. This includes users that can browse projects that the filter is shared with. If you don’t specify sharedUsers, then the sharedUsers object is returned but it doesn’t list any users. The list of users returned is limited to 1000, to access additional users append [start-index:end-index] to the expand request. For example, to access the next 1000 users, use ?expand=sharedUsers[1001:2000].
subscriptions Returns the users that are subscribed to the filter. If you don’t specify subscriptions, the subscriptions object is returned but it doesn’t list any subscriptions. The list of subscriptions returned is limited to 1000, to access additional subscriptions append [start-index:end-index] to the expand request. For example, to access the next 1000 subscriptions, use ?expand=subscriptions[1001:2000].

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-85)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-85)For Configurations - [Configurations](#Config) ### [](#throws-85)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3FilterPermissionByIdPermissionId)Delete Share Permission `` Deletes a share permission from a filter. **Permissions required:** Permission to access Jira and the user must own the filter. This operation makes an HTTP DELETE request to the /rest/api/3/filter/{id}/permission/{permissionId} endpoint. ### [](#parameters-87)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the filter.

Permission Id

Number

The ID of the share permission.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-86)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-86)For Configurations - [Configurations](#Config) ### [](#throws-86)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3Group)Remove Group `` Deletes a group. **Permissions required:** Site administration (that is, member of the **site-admin** strategic [group](https://support.atlassian.com/user-management/docs/manage-groups/)). This operation makes an HTTP DELETE request to the /rest/api/3/group endpoint. ### [](#parameters-88)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

groupname

String

The name of the group.

Swap Group

String

The group to transfer restrictions to. Only comments and worklogs are transferred. If restrictions are not transferred, comments and worklogs are inaccessible after the deletion.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-87)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-87)For Configurations - [Configurations](#Config) ### [](#throws-87)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3GroupUser)Remove User From Group `` Removes a user from a group. **Permissions required:** Site administration (that is, member of the **site-admin** [group](https://support.atlassian.com/user-management/docs/manage-groups/)). This operation makes an HTTP DELETE request to the /rest/api/3/group/user endpoint. ### [](#parameters-89)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

groupname

String

The name of the group.

username

String

This parameter is no longer available and will be removed from the documentation soon. See the [deprecation notice](https://docs.mulesoft.com/jira-connector/latest/%3Ca href="https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/" class="bare">https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/) for details.

Account Id

String

The account ID of the user, which uniquely identifies the user across all Atlassian products. For example, 5b10ac8d82e05b22cc7d4ef5.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-88)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-88)For Configurations - [Configurations](#Config) ### [](#throws-88)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3IssueByIssueIdOrKey)Delete Issue `` Deletes an issue. An issue cannot be deleted if it has one or more subtasks. To delete an issue with subtasks, set `deleteSubtasks`. This causes the issue’s subtasks to be deleted with the issue. This operation can be accessed anonymously. **Permissions required:** - **Browse projects** and **Delete issues** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project containing the issue. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP DELETE request to the /rest/api/3/issue/{issueIdOrKey} endpoint. ### [](#parameters-90)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Delete Subtasks

Enumeration, one of:

TRUE
FALSE

Whether the issue’s subtasks are deleted when the issue is deleted.

FALSE

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-89)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-89)For Configurations - [Configurations](#Config) ### [](#throws-89)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3IssueCommentByIssueIdOrKeyId)Delete Comment `` Deletes a comment. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue containing the comment is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. - **Delete all comments** [project permission](https://confluence.atlassian.com/x/yodKLg) to delete any comment or **Delete own comments** to delete comment created by the user. - If the comment has visibility restrictions, the user belongs to the group or has the role visibility is restricted to. This operation makes an HTTP DELETE request to the /rest/api/3/issue/{issueIdOrKey}/comment/{id} endpoint. ### [](#parameters-91)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

String

The ID of the comment.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-90)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-90)For Configurations - [Configurations](#Config) ### [](#throws-90)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3IssueLinkByLinkId)Delete Issue Link `` Deletes an issue link. This operation can be accessed anonymously. **Permissions required:** - Browse project [project permission](https://confluence.atlassian.com/x/yodKLg) for all the projects containing the issues in the link. - **Link issues** [project permission](https://confluence.atlassian.com/x/yodKLg) for at least one of the projects containing issues in the link. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, permission to view both of the issues. This operation makes an HTTP DELETE request to the /rest/api/3/issueLink/{linkId} endpoint. ### [](#parameters-92)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Link Id

String

The ID of the issue link.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-91)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-91)For Configurations - [Configurations](#Config) ### [](#throws-91)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3IssueLinkTypeByIssueLinkTypeId)Delete Issue Link Type `` Deletes an issue link type. To use this operation, the site must have [issue linking](https://confluence.atlassian.com/x/yoXKM) enabled. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP DELETE request to the /rest/api/3/issueLinkType/{issueLinkTypeId} endpoint. ### [](#parameters-93)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Link Type Id

String

The ID of the issue link type.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-92)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-92)For Configurations - [Configurations](#Config) ### [](#throws-92)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3IssuePropertiesByIssueIdOrKeyPropertyKey)Delete Issue Property `` Deletes an issue’s property. This operation can be accessed anonymously. **Permissions required:** - **Browse projects** and **Edit issues** \[project permissions\](https://docs.mulesoft.com/jira-connector/latest/[https://confluence.atlassian.com/x/yodKLg](https://confluence.atlassian.com/x/yodKLg)) for the project containing the issue. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP DELETE request to the /rest/api/3/issue/{issueIdOrKey}/properties/{propertyKey} endpoint. ### [](#parameters-94)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The key or ID of the issue.

Property Key

String

The key of the property.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-93)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-93)For Configurations - [Configurations](#Config) ### [](#throws-93)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3IssuePropertiesByPropertyKey)Bulk Delete Issue Property `` Deletes a property value from multiple issues. The issues to be updated can be specified by filter criteria. The criteria the filter used to identify eligible issues are: - `entityIds` Only issues from this list are eligible. - `currentValue` Only issues with the property set to this value are eligible. If both criteria is specified, they are joined with the logical **AND**: only issues that satisfy both criteria are considered eligible. If no filter criteria are specified, all the issues visible to the user and where the user has the EDIT\\\_ISSUES permission for the issue are considered eligible. This operation is: - transactional, either the property is deleted from all eligible issues or, when errors occur, no properties are deleted. - \[asynchronous\](#async). Follow the `location` link in the response to determine the status of the task and use \[Get task\](#api-rest-api-3-task-taskId-get) to obtain subsequent updates. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for each project containing issues. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. - **Edit issues** [project permission](https://confluence.atlassian.com/x/yodKLg) for each issue. This operation makes an HTTP DELETE request to the /rest/api/3/issue/properties/{propertyKey} endpoint. ### [](#parameters-95)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Property Key

String

The key of the property.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-94)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-94)For Configurations - [Configurations](#Config) ### [](#throws-94)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3IssueRemotelinkByIssueIdOrKey)Delete Remote Issue Link By Global Id `` Deletes the remote issue link from the issue using the link’s global ID. Where the global ID includes reserved URL characters, these must be escaped in the request, for example, pass `system=http://www.mycompany.com/support&id=1` as `system%3Dhttp%3A%2F%2Fwww.mycompany.com%2Fsupport%26id%3D1`. This operation requires [issue linking to be active](https://confluence.atlassian.com/x/yoXKM). This operation can be accessed anonymously. **Permissions required:** - **Browse projects** and **Link issues** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is implemented, issue-level security permission to view the issue. This operation makes an HTTP DELETE request to the /rest/api/3/issue/{issueIdOrKey}/remotelink endpoint. ### [](#parameters-96)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Global Id

String

The global ID of a remote issue link.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-95)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-95)For Configurations - [Configurations](#Config) ### [](#throws-95)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3IssueRemotelinkByIssueIdOrKeyLinkId)Delete Remote Issue Link By Id `` Deletes a remote issue link from an issue. This operation requires [issue linking to be active](https://confluence.atlassian.com/x/yoXKM). This operation can be accessed anonymously. **Permissions required:** - **Browse projects**, **Edit issues**, and **Link issues** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP DELETE request to the /rest/api/3/issue/{issueIdOrKey}/remotelink/{linkId} endpoint. ### [](#parameters-97)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Link Id

String

The ID of a remote issue link.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-96)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-96)For Configurations - [Configurations](#Config) ### [](#throws-96)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3IssueVotesByIssueIdOrKey)Remove Vote `` Deletes a user’s vote from an issue. This is the equivalent of the user clicking **Unvote** on an issue in Jira. This operation requires the **Allow users to vote on issues** option to be **ON**. This option is set in General configuration for Jira. See [Configuring Jira application options](https://confluence.atlassian.com/x/uYXKM) for details. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP DELETE request to the /rest/api/3/issue/{issueIdOrKey}/votes endpoint. ### [](#parameters-98)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-97)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-97)For Configurations - [Configurations](#Config) ### [](#throws-97)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3IssueWatchersByIssueIdOrKey)Remove Watcher `` Deletes a user as a watcher of an issue. This operation requires the **Allow users to watch issues** option to be **ON**. This option is set in General configuration for Jira. See [Configuring Jira application options](https://confluence.atlassian.com/x/uYXKM) for details. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. - To remove users other than themselves from the watchlist, **Manage watcher list** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. This operation makes an HTTP DELETE request to the /rest/api/3/issue/{issueIdOrKey}/watchers endpoint. ### [](#parameters-99)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

username

String

Account Id

String

The account ID of the user, which uniquely identifies the user across all Atlassian products. For example, 5b10ac8d82e05b22cc7d4ef5. Required.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-98)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-98)For Configurations - [Configurations](#Config) ### [](#throws-98)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3IssueWorklogByIssueIdOrKeyId)Delete Worklog `` Deletes a worklog from an issue. Time tracking must be enabled in Jira, otherwise this operation returns an error. For more information, see [Configuring time tracking](https://confluence.atlassian.com/x/qoXKM). This operation can be accessed anonymously. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. - **Delete all worklogs** [project permission](https://confluence.atlassian.com/x/yodKLg) to delete any worklog or **Delete own worklogs** to delete worklogs created by the user, - If the worklog has visibility restrictions, belongs to the group or has the role visibility is restricted to. This operation makes an HTTP DELETE request to the /rest/api/3/issue/{issueIdOrKey}/worklog/{id} endpoint. ### [](#parameters-100)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

String

The ID of the worklog.

Notify Users

Boolean

Whether users watching the issue are notified by email.

true

Adjust Estimate

Enumeration, one of:

NEW
LEAVE
MANUAL
AUTO

Defines how to update the issue’s time estimate, the options are: * new Sets the estimate to a specific value, defined in newEstimate. * leave Leaves the estimate unchanged. * manual Increases the estimate by amount specified in increaseBy. * auto Reduces the estimate by the value of timeSpent in the worklog.

AUTO

New Estimate

String

The value to set as the issue’s remaining time estimate, as days (#d), hours (\#h), or minutes (\#m or \#), for example, 2d. Required when adjustEstimate is new.

Increase By

String

The amount to increase the issue’s remaining estimate by, as days (#d), hours (\#h), or minutes (\#m or \#), for example, 2d. Required when adjustEstimate is manual.

Override Editable Flag

Boolean

Whether the work log entry should be added to the issue even if the issue is not editable, because jira.issue.editable is set to false or missing, for example, the issue is closed. Only Connect app users with admin permissions can use this flag.

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-99)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-99)For Configurations - [Configurations](#Config) ### [](#throws-99)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3IssueWorklogPropertiesByIssueIdOrKeyWorklogIdPropertyKey)Delete Worklog Property `` Deletes a worklog property. This operation can be accessed anonymously. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. - If the worklog has visibility restrictions, belongs to the group or has the role visibility is restricted to. This operation makes an HTTP DELETE request to the /rest/api/3/issue/{issueIdOrKey}/worklog/{worklogId}/properties/{propertyKey} endpoint. ### [](#parameters-101)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Worklog Id

String

The ID of the worklog.

Property Key

String

The key of the property.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-100)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-100)For Configurations - [Configurations](#Config) ### [](#throws-100)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3IssuetypeById)Delete Issue Type `` Deletes the issue type. If the issue type is in use, all uses are updated with the alternative issue type (`alternativeIssueTypeId`). A list of alternative issue types are obtained from the \[Get alternative issue types\](#api-rest-api-3-issuetype-id-alternatives-get) resource. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP DELETE request to the /rest/api/3/issuetype/{id} endpoint. ### [](#parameters-102)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the issue type.

Alternative Issue Type Id

String

The ID of the replacement issue type.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-101)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-101)For Configurations - [Configurations](#Config) ### [](#throws-101)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3IssuetypePropertiesByIssueTypeIdPropertyKey)Delete Issue Type Property `` Deletes the [issue type property](https://developer.atlassian.com/cloud/jira/platform/storing-data-with-entity-properties/). **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/issuetype/{issueTypeId}/properties/{propertyKey} endpoint. ### [](#parameters-103)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Type Id

String

The ID of the issue type.

Property Key

String

The key of the property. Use [Get issue type property keys](#api-rest-api-3-issuetype-issueTypeId-properties-get) to get a list of all issue type property keys.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-102)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-102)For Configurations - [Configurations](#Config) ### [](#throws-102)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3IssuetypeschemeByIssueTypeSchemeId)Delete Issue Type Scheme `` Deletes an issue type scheme. Only issue type schemes used in classic projects can be deleted. Any projects assigned to the scheme are reassigned to the default issue type scheme. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/issuetypescheme/{issueTypeSchemeId} endpoint. ### [](#parameters-104)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Type Scheme Id

Number

The ID of the issue type scheme.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-103)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-103)For Configurations - [Configurations](#Config) ### [](#throws-103)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3IssuetypeschemeIssuetypeByIssueTypeSchemeIdIssueTypeId)Remove Issue Type From Issue Type Scheme `` Removes an issue type from an issue type scheme. This operation cannot remove: - any issue type used by issues. - any issue types from the default issue type scheme. - the last standard issue type from an issue type scheme. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/issuetypescheme/{issueTypeSchemeId}/issuetype/{issueTypeId} endpoint. ### [](#parameters-105)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Type Scheme Id

Number

The ID of the issue type scheme.

Issue Type Id

Number

The ID of the issue type.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-104)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-104)For Configurations - [Configurations](#Config) ### [](#throws-104)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3IssuetypescreenschemeByIssueTypeScreenSchemeId)Delete Issue Type Screen Scheme `` Deletes an issue type screen scheme. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/issuetypescreenscheme/{issueTypeScreenSchemeId} endpoint. ### [](#parameters-106)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Type Screen Scheme Id

String

The ID of the issue type screen scheme.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-105)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-105)For Configurations - [Configurations](#Config) ### [](#throws-105)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3Mypreferences)Remove Preference `` Deletes a preference of the user, which restores the default value of system defined settings. Note that these keys are deprecated: - **jira.user.locale** The locale of the user. By default, not set. The user takes the instance locale. - **jira.user.timezone** The time zone of the user. By default, not set. The user takes the instance timezone. Use [Update a user profile](https://developer.atlassian.com/cloud/admin/user-management/rest/#api-users-account-id-manage-profile-patch) from the user management REST API to manage timezone and locale instead. **Permissions required:** Permission to access Jira. This operation makes an HTTP DELETE request to the /rest/api/3/mypreferences endpoint. ### [](#parameters-107)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

key

String

The key of the preference.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-106)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-106)For Configurations - [Configurations](#Config) ### [](#throws-106)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3PermissionschemeBySchemeId)Delete Permission Scheme `` Deletes a permission scheme. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/permissionscheme/{schemeId} endpoint. ### [](#parameters-108)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Scheme Id

Number

The ID of the permission scheme being deleted.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-107)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-107)For Configurations - [Configurations](#Config) ### [](#throws-107)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3PermissionschemePermissionBySchemeIdPermissionId)Delete Permission Scheme Entity `` Deletes a permission grant from a permission scheme. See \[About permission schemes and grants\](#about-permission-schemes) for more details. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/permissionscheme/{schemeId}/permission/{permissionId} endpoint. ### [](#parameters-109)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Scheme Id

Number

The ID of the permission scheme to delete the permission grant from.

Permission Id

Number

The ID of the permission grant to delete.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-108)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-108)For Configurations - [Configurations](#Config) ### [](#throws-108)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3ProjectAvatarByProjectIdOrKeyId)Delete Project Avatar `` Deletes a custom avatar from a project. Note that system avatars cannot be deleted. **Permissions required:** **Administer projects** [project permission](https://confluence.atlassian.com/x/yodKLg) This operation makes an HTTP DELETE request to the /rest/api/3/project/{projectIdOrKey}/avatar/{id} endpoint. ### [](#parameters-110)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or (case-sensitive) key.

Number

The ID of the avatar.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-109)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-109)For Configurations - [Configurations](#Config) ### [](#throws-109)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3ProjectByProjectIdOrKey)Delete Project `` Deletes a project. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/project/{projectIdOrKey} endpoint. ### [](#parameters-111)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or project key (case sensitive).

Enable Undo

Boolean

Whether this project is placed in the Jira recycle bin where it will be available for restoration.

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-110)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-110)For Configurations - [Configurations](#Config) ### [](#throws-110)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3ProjectCategoryById)Remove Project Category `` Deletes a project category. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/projectCategory/{id} endpoint. ### [](#parameters-112)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

ID of the project category to delete.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-111)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-111)For Configurations - [Configurations](#Config) ### [](#throws-111)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3ProjectPropertiesByProjectIdOrKeyPropertyKey)Delete Project Property `` Deletes the [property](https://developer.atlassian.com/cloud/jira/platform/storing-data-with-entity-properties/) from a project. This operation can be accessed anonymously. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) or **Administer Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project containing the property. This operation makes an HTTP DELETE request to the /rest/api/3/project/{projectIdOrKey}/properties/{propertyKey} endpoint. ### [](#parameters-113)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or project key (case sensitive).

Property Key

String

The project property key. Use [Get project property keys](#api-rest-api-3-project-projectIdOrKey-properties-get) to get a list of all project property keys.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-112)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-112)For Configurations - [Configurations](#Config) ### [](#throws-112)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3ProjectRoleByProjectIdOrKeyId)Delete Actor `` Deletes actors from a project role for the project. To remove default actors from the project role, use \[Delete default actors from project role\](#api-rest-api-3-role-id-actors-delete). This operation can be accessed anonymously. **Permissions required:** **Administer Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project or **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP DELETE request to the /rest/api/3/project/{projectIdOrKey}/role/{id} endpoint. ### [](#parameters-114)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or project key (case sensitive).

Number

The ID of the project role. Use [Get all project roles](#api-rest-api-3-role-get) to get a list of project role IDs.

user

String

The user account ID of the user to remove from the project role.

group

String

The name of the group to remove from the project role.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-113)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-113)For Configurations - [Configurations](#Config) ### [](#throws-113)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3RoleActorsById)Delete Project Role Actors From Role `` Deletes the \[default actors\](#api-rest-api-3-resolution-get) from a project role. You can delete a group or user, but you cannot delete a group and a user in the same request. Changing a project role’s default actors does not affect project role members for projects already created. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/role/{id}/actors endpoint. ### [](#parameters-115)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the project role. Use [Get all project roles](#api-rest-api-3-role-get) to get a list of project role IDs.

user

String

The user account ID of the user to remove as a default actor.

group

String

The group name of the group to be removed as a default actor.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-114)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-114)For Configurations - [Configurations](#Config) ### [](#throws-114)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3RoleById)Delete Project Role `` Deletes a project role. You must specify a replacement project role if you wish to delete a project role that is in use. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/role/{id} endpoint. ### [](#parameters-116)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the project role to delete. Use [Get all project roles](#api-rest-api-3-role-get) to get a list of project role IDs.

swap

Number

The ID of the project role that will replace the one being deleted.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-115)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-115)For Configurations - [Configurations](#Config) ### [](#throws-115)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3ScreensByScreenId)Delete Screen `` Deletes a screen. A screen cannot be deleted if it is used in a screen scheme, workflow, or workflow draft. Only screens used in classic projects can be deleted. This operation makes an HTTP DELETE request to the /rest/api/3/screens/{screenId} endpoint. ### [](#parameters-117)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Screen Id

Number

The ID of the screen.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-116)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-116)For Configurations - [Configurations](#Config) ### [](#throws-116)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3ScreensTabsByScreenIdTabId)Delete Screen Tab `` Deletes a screen tab. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/screens/{screenId}/tabs/{tabId} endpoint. ### [](#parameters-118)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Screen Id

Number

The ID of the screen.

Tab Id

Number

The ID of the screen tab.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-117)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-117)For Configurations - [Configurations](#Config) ### [](#throws-117)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3ScreensTabsFieldsByScreenIdTabIdId)Remove Screen Tab Field `` Removes a field from a screen tab. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/screens/{screenId}/tabs/{tabId}/fields/{id} endpoint. ### [](#parameters-119)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Screen Id

Number

The ID of the screen.

Tab Id

Number

The ID of the screen tab.

String

The ID of the field.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-118)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-118)For Configurations - [Configurations](#Config) ### [](#throws-118)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3ScreenschemeByScreenSchemeId)Delete Screen Scheme `` Deletes a screen scheme. A screen scheme cannot be deleted if it is used in an issue type screen scheme. Only screens schemes used in classic projects can be deleted. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/screenscheme/{screenSchemeId} endpoint. ### [](#parameters-120)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Screen Scheme Id

String

The ID of the screen scheme.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-119)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-119)For Configurations - [Configurations](#Config) ### [](#throws-119)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3UniversalAvatarTypeOwnerAvatarByTypeOwningObjectIdId)Delete Avatar `` Deletes an avatar from a project or issue type. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/universal\_avatar/type/{type}/owner/{owningObjectId}/avatar/{id} endpoint. ### [](#parameters-121)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

type

Enumeration, one of:

PROJECT
ISSUETYPE

The avatar type.

Owning Object Id

String

The ID of the item the avatar is associated with.

Number

The ID of the avatar.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-120)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-120)For Configurations - [Configurations](#Config) ### [](#throws-120)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3User)Remove User `` Deletes a user. **Permissions required:** Site administration (that is, membership of the **site-admin** [group](https://support.atlassian.com/user-management/docs/manage-groups/)). This operation makes an HTTP DELETE request to the /rest/api/3/user endpoint. ### [](#parameters-122)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Account Id

String

The account ID of the user, which uniquely identifies the user across all Atlassian products. For example, 5b10ac8d82e05b22cc7d4ef5.

username

String

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

key

String

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-121)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-121)For Configurations - [Configurations](#Config) ### [](#throws-121)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3UserColumns)Reset User Columns `` Resets the default [issue table columns](https://confluence.atlassian.com/x/XYdKLg) for the user to the system default. If `accountId` is not passed, the calling user’s default columns are reset. **Permissions required:** - **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg), to set the columns on any user. - Permission to access Jira, to set the calling user’s columns. This operation makes an HTTP DELETE request to the /rest/api/3/user/columns endpoint. ### [](#parameters-123)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Account Id

String

The account ID of the user, which uniquely identifies the user across all Atlassian products. For example, 5b10ac8d82e05b22cc7d4ef5.

username

String

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-122)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-122)For Configurations - [Configurations](#Config) ### [](#throws-122)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3UserPropertiesByPropertyKey)Delete User Property `` Deletes a property from a user. Note: This operation does not access the [user properties](https://support.atlassian.com/user-management/docs/update-roles-and-properties-for-jira-users/) created and maintained in Jira. **Permissions required:** - **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg), to delete a property from any user. - Access to Jira, to delete a property from the calling user’s record. This operation makes an HTTP DELETE request to the /rest/api/3/user/properties/{propertyKey} endpoint. ### [](#parameters-124)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Property Key

String

The key of the user’s property.

Account Id

String

The account ID of the user, which uniquely identifies the user across all Atlassian products. For example, 5b10ac8d82e05b22cc7d4ef5.

User Key

String

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

username

String

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-123)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-123)For Configurations - [Configurations](#Config) ### [](#throws-123)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3Webhook)Delete Webhook By Id `` Removes webhooks by ID. Only webhooks registered by the calling Connect app are removed. If webhooks created by other apps are specified, they are ignored. **Permissions required:** Only [Connect apps](https://developer.atlassian.com/cloud/jira/platform/index/) can use this operation. This operation makes an HTTP DELETE request to the /rest/api/3/webhook endpoint. ### [](#parameters-125)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-124)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-124)For Configurations - [Configurations](#Config) ### [](#throws-124)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3WorkflowTransitionsPropertiesByTransitionId)Delete Workflow Transition Property `` Deletes a property from a workflow transition. Transition properties are used to change the behavior of a transition. For more information, see [Transition properties](https://confluence.atlassian.com/x/zIhKLg#Advancedworkflowconfiguration-transitionproperties) and [Workflow properties](https://confluence.atlassian.com/x/JYlKLg). **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/workflow/transitions/{transitionId}/properties endpoint. ### [](#parameters-126)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Transition Id

Number

The ID of the transition. To get the ID, view the workflow in text mode in the Jira admin settings. The ID is shown next to the transition.

key

String

The name of the transition property to delete, also known as the name of the property.

Workflow Name

String

The name of the workflow that the transition belongs to.

Workflow Mode

Enumeration, one of:

LIVE
DRAFT

The workflow status. Set to live for inactive workflows or draft for draft workflows. Active workflows cannot be edited.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-125)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-125)For Configurations - [Configurations](#Config) ### [](#throws-125)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3WorkflowschemeById)Delete Workflow Scheme `` Deletes a workflow scheme. Note that a workflow scheme cannot be deleted if it is active (that is, being used by at least one project). **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/workflowscheme/{id} endpoint. ### [](#parameters-127)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the workflow scheme. Find this ID by editing the desired workflow scheme in Jira. The ID is shown in the URL as schemeId. For example, schemeId=10301.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-126)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-126)For Configurations - [Configurations](#Config) ### [](#throws-126)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3WorkflowschemeDefaultById)Delete Default Workflow `` Resets the default workflow for a workflow scheme. That is, the default workflow is set to Jira’s system workflow (the **jira** workflow). Note that active workflow schemes cannot be edited. If the workflow scheme is active, set `updateDraftIfNeeded` to `true` and a draft workflow scheme is created or updated with the default workflow reset. The draft workflow scheme can be published in Jira. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/workflowscheme/{id}/default endpoint. ### [](#parameters-128)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the workflow scheme.

Update Draft If Needed

Boolean

Set to true to create or update the draft of a workflow scheme and delete the mapping from the draft, when the workflow scheme cannot be edited. Defaults to false.

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-127)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-127)For Configurations - [Configurations](#Config) ### [](#throws-127)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3WorkflowschemeDraftById)Delete Workflow Scheme Draft `` Deletes a draft workflow scheme. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/workflowscheme/{id}/draft endpoint. ### [](#parameters-129)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the active workflow scheme that the draft was created from.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-128)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-128)For Configurations - [Configurations](#Config) ### [](#throws-128)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3WorkflowschemeDraftDefaultById)Delete Draft Default Workflow `` Resets the default workflow for a workflow scheme’s draft. That is, the default workflow is set to Jira’s system workflow (the **jira** workflow). **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/workflowscheme/{id}/draft/default endpoint. ### [](#parameters-130)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the workflow scheme that the draft belongs to.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-129)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-129)For Configurations - [Configurations](#Config) ### [](#throws-129)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3WorkflowschemeDraftIssuetypeByIdIssueType)Delete Workflow Scheme Draft Issue Type `` Deletes the issue type-workflow mapping for an issue type in a workflow scheme’s draft. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/workflowscheme/{id}/draft/issuetype/{issueType} endpoint. ### [](#parameters-131)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the workflow scheme that the draft belongs to.

Issue Type

String

The ID of the issue type.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-130)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-130)For Configurations - [Configurations](#Config) ### [](#throws-130)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3WorkflowschemeDraftWorkflowById)Delete Draft Workflow Mapping `` Deletes the workflow-issue type mapping for a workflow in a workflow scheme’s draft. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/workflowscheme/{id}/draft/workflow endpoint. ### [](#parameters-132)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the workflow scheme that the draft belongs to.

Workflow Name

String

The name of the workflow.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-131)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-131)For Configurations - [Configurations](#Config) ### [](#throws-131)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3WorkflowschemeIssuetypeByIdIssueType)Delete Workflow Scheme Issue Type `` Deletes the issue type-workflow mapping for an issue type in a workflow scheme. Note that active workflow schemes cannot be edited. If the workflow scheme is active, set `updateDraftIfNeeded` to `true` and a draft workflow scheme is created or updated with the issue type-workflow mapping deleted. The draft workflow scheme can be published in Jira. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/workflowscheme/{id}/issuetype/{issueType} endpoint. ### [](#parameters-133)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the workflow scheme.

Issue Type

String

The ID of the issue type.

Update Draft If Needed

Boolean

Set to true to create or update the draft of a workflow scheme and update the mapping in the draft, when the workflow scheme cannot be edited. Defaults to false.

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-132)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-132)For Configurations - [Configurations](#Config) ### [](#throws-132)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestApi3WorkflowschemeWorkflowById)Delete Workflow Mapping `` Deletes the workflow-issue type mapping for a workflow in a workflow scheme. Note that active workflow schemes cannot be edited. If the workflow scheme is active, set `updateDraftIfNeeded` to `true` and a draft workflow scheme is created or updated with the workflow-issue type mapping deleted. The draft workflow scheme can be published in Jira. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP DELETE request to the /rest/api/3/workflowscheme/{id}/workflow endpoint. ### [](#parameters-134)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the workflow scheme.

Workflow Name

String

The name of the workflow.

Update Draft If Needed

Boolean

Set to true to create or update the draft of a workflow scheme and delete the mapping from the draft, when the workflow scheme cannot be edited. Defaults to false.

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-133)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-133)For Configurations - [Configurations](#Config) ### [](#throws-133)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestAtlassianConnect1AddonsPropertiesByAddonKeyPropertyKey)Addon Properties Resource delete Addon Property delete `` Deletes an app’s property. **Permissions required:** Only a Connect app whose key matches `addonKey` can make this request. This operation makes an HTTP DELETE request to the /rest/atlassian-connect/1/addons/{addonKey}/properties/{propertyKey} endpoint. ### [](#parameters-135)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Addon Key

String

The key of the app, as defined in its descriptor.

Property Key

String

The key of the property.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-134)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-134)For Configurations - [Configurations](#Config) ### [](#throws-134)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#DeleteRestAtlassianConnect1AppModuleDynamic)Dynamic Modules Resource remove Modules delete `` Remove all or a list of modules registered by the calling app. **Permissions required:** Only Connect apps can make this request. This operation makes an HTTP DELETE request to the /rest/atlassian-connect/1/app/module/dynamic endpoint. ### [](#parameters-136)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Module Key

Array of String

The key of the module to remove. To include multiple module keys, provide multiple copies of this parameter. For example, moduleKey=dynamic-attachment-entity-property&moduleKey=dynamic-select-field. Nonexistent keys are ignored.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-135)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-135)For Configurations - [Configurations](#Config) ### [](#throws-135)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ApplicationProperties)Get Application Property `` Returns all application properties or an application property. If you specify a value for the `key` parameter, then an application property is returned as an object (not in an array). Otherwise, an array of all editable application properties is returned. See \[Set application property\](#api-rest-api-3-application-properties-id-put) for descriptions of editable properties. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/application-properties endpoint. ### [](#parameters-137)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

key

String

The key of the application property.

Permission Level

String

The permission level of all items being returned in the list.

Key Filter

String

When a key isn’t provided, this filters the list of results by the application property key using a regular expression. For example, using jira.lf. will return all application properties with keys that start with *jira.lf..

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-136)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-136)For Configurations - [Configurations](#Config) ### [](#throws-136)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ApplicationPropertiesAdvancedSettings)Get Advanced Settings `` Returns the application properties that are accessible on the **Advanced Settings** page. To navigate to the **Advanced Settings** page in Jira, choose the Jira icon > **Jira settings** > **System**, **General Configuration** and then click **Advanced Settings** (in the upper right). **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/application-properties/advanced-settings endpoint. ### [](#parameters-138)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-137)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-137)For Configurations - [Configurations](#Config) ### [](#throws-137)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Applicationrole)Get All Application Roles `` Returns all application roles. In Jira, application roles are managed using the [Application access configuration](https://support.atlassian.com/user-management/docs/give-users-access-to-products/) page. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/applicationrole endpoint. ### [](#parameters-139)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-138)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-138)For Configurations - [Configurations](#Config) ### [](#throws-138)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ApplicationroleByKey)Get Application Role `` Returns an application role. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/applicationrole/{key} endpoint. ### [](#parameters-140)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

key

String

The key of the application role. Use the [Get all application roles](#api-rest-api-3-applicationrole-get) operation to get the key for each application role.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-139)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-139)For Configurations - [Configurations](#Config) ### [](#throws-139)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3AttachmentById)Get Attachment `` Returns the metadata for an attachment. Note that the attachment itself is not returned. This operation can be accessed anonymously. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP GET request to the /rest/api/3/attachment/{id} endpoint. ### [](#parameters-141)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the attachment.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-140)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-140)For Configurations - [Configurations](#Config) ### [](#throws-140)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3AttachmentExpandHumanById)Expand Attachment For Humans `` Returns the metadata for the contents of an attachment, if it is an archive, and metadata for the attachment itself. For example, if the attachment is a ZIP archive, then information about the files in the archive is returned and metadata for the ZIP archive. Currently, only the ZIP archive format is supported. Use this operation to retrieve data that is presented to the user, as this operation returns the metadata for the attachment itself, such as the attachment’s ID and name. Otherwise, use \[Get contents metadata for an expanded attachment\](#api-rest-api-3-attachment-id-expand-raw-get), which only returns the metadata for the attachment’s contents. This operation can be accessed anonymously. **Permissions required:** For the issue containing the attachment: - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP GET request to the /rest/api/3/attachment/{id}/expand/human endpoint. ### [](#parameters-142)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the attachment.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-141)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-141)For Configurations - [Configurations](#Config) ### [](#throws-141)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3AttachmentExpandRawById)Expand Attachment For Machines `` Returns the metadata for the contents of an attachment, if it is an archive. For example, if the attachment is a ZIP archive, then information about the files in the archive is returned. Currently, only the ZIP archive format is supported. Use this operation if you are processing the data without presenting it to the user, as this operation only returns the metadata for the contents of the attachment. Otherwise, to retrieve data to present to the user, use \[Get all metadata for an expanded attachment\](#api-rest-api-3-attachment-id-expand-human-get) which also returns the metadata for the attachment itself, such as the attachment’s ID and name. This operation can be accessed anonymously. **Permissions required:** For the issue containing the attachment: - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP GET request to the /rest/api/3/attachment/{id}/expand/raw endpoint. ### [](#parameters-143)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the attachment.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-142)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-142)For Configurations - [Configurations](#Config) ### [](#throws-142)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3AttachmentMeta)Get Attachment Meta `` Returns the attachment settings, that is, whether attachments are enabled and the maximum attachment size allowed. Note that there are also [project permissions](https://confluence.atlassian.com/x/yodKLg) that restrict whether users can create and delete attachments. This operation can be accessed anonymously. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/attachment/meta endpoint. ### [](#parameters-144)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-143)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-143)For Configurations - [Configurations](#Config) ### [](#throws-143)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3AuditingRecord)Get Audit Records `` Returns a list of audit records. The list can be filtered to include items: - containing a string in at least one field. For example, providing **up** will return all audit records where one or more fields contains words such as **update**. - created on or after a date and time. - created on or before a date and time. - created during a time period. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/auditing/record endpoint. ### [](#parameters-145)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

offset

Number

The number of records to skip before returning the first result.

limit

Number

The maximum number of results to return.

1000

filter

String

The query string.

from

String

The date and time on or after which returned audit records must have been created. If to is provided from must be before to or no audit records are returned.

String

The date and time on or before which returned audit results must have been created. If from is provided to must be after from or no audit records are returned.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-144)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-144)For Configurations - [Configurations](#Config) ### [](#throws-144)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3AvatarSystemByType)Get All System Avatars `` Returns a list of system avatar details by owner type, where the owner types are issue type, project, or user. This operation can be accessed anonymously. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/avatar/{type}/system endpoint. ### [](#parameters-146)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

type

Enumeration, one of:

ISSUETYPE
PROJECT
USER

The avatar type.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-145)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-145)For Configurations - [Configurations](#Config) ### [](#throws-145)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3CommentPropertiesByCommentId)Get Comment Property Keys `` Returns the keys of all the properties of a comment. This operation can be accessed anonymously. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. - If the comment has visibility restrictions, belongs to the group or has the role visibility is restricted to. This operation makes an HTTP GET request to the /rest/api/3/comment/{commentId}/properties endpoint. ### [](#parameters-147)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Comment Id

String

The ID of the comment.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-146)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-146)For Configurations - [Configurations](#Config) ### [](#throws-146)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3CommentPropertiesByCommentIdPropertyKey)Get Comment Property `` Returns the value of a comment property. This operation can be accessed anonymously. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. - If the comment has visibility restrictions, belongs to the group or has the role visibility is restricted to. This operation makes an HTTP GET request to the /rest/api/3/comment/{commentId}/properties/{propertyKey} endpoint. ### [](#parameters-148)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Comment Id

String

The ID of the comment.

Property Key

String

The key of the property.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-147)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-147)For Configurations - [Configurations](#Config) ### [](#throws-147)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ComponentById)Get Component `` Returns a component. This operation can be accessed anonymously. **Permissions required:** **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for project containing the component. This operation makes an HTTP GET request to the /rest/api/3/component/{id} endpoint. ### [](#parameters-149)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the component.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-148)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-148)For Configurations - [Configurations](#Config) ### [](#throws-148)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ComponentRelatedIssueCountsById)Get Component Related Issues `` Returns the counts of issues assigned to the component. This operation can be accessed anonymously. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/component/{id}/relatedIssueCounts endpoint. ### [](#parameters-150)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the component.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-149)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-149)For Configurations - [Configurations](#Config) ### [](#throws-149)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Configuration)Get Configuration `` Returns the [global settings](https://confluence.atlassian.com/x/qYXKM) in Jira. These settings determine whether optional features (for example, subtasks, time tracking, and others) are enabled. If time tracking is enabled, this operation also returns the time tracking configuration. This operation can be accessed anonymously. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/configuration endpoint. ### [](#parameters-151)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-150)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-150)For Configurations - [Configurations](#Config) ### [](#throws-150)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ConfigurationTimetracking)Get Selected Time Tracking Implementation `` Returns the time tracking provider that is currently selected. Note that if time tracking is disabled, then a successful but empty response is returned. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/configuration/timetracking endpoint. ### [](#parameters-152)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-151)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-151)For Configurations - [Configurations](#Config) ### [](#throws-151)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ConfigurationTimetrackingList)Get Available Time Tracking Implementations `` Returns all time tracking providers. By default, Jira only has one time tracking provider: **JIRA provided time tracking**. However, you can install other time tracking providers via apps from the Atlassian Marketplace. For more information on time tracking providers, see the documentation for the [Time Tracking Provider](https://developer.atlassian.com/cloud/jira/platform/modules/time-tracking-provider/) module. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/configuration/timetracking/list endpoint. ### [](#parameters-153)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-152)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-152)For Configurations - [Configurations](#Config) ### [](#throws-152)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ConfigurationTimetrackingOptions)Get Shared Time Tracking Configuration `` Returns the time tracking settings. This includes settings such as the time format, default time unit, and others. For more information, see [Configuring time tracking](https://confluence.atlassian.com/x/qoXKM). **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/configuration/timetracking/options endpoint. ### [](#parameters-154)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-153)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-153)For Configurations - [Configurations](#Config) ### [](#throws-153)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3CustomFieldOptionByFieldId)Get Options For Field `` This operation is deprecated and becomes unavailable on 8 May 2021. Use [Get custom field options (context)](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-custom-field-options/#api-rest-api-3-field-fieldid-context-contextid-option-get) instead. See [Deprecation of custom field options](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-removal-of-custom-field-options-operations/) for details. Returns a paginated list of options and, where the custom select field is of the type **Select List (cascading)**, cascading options for custom select fields. Cascading options are included in the item count when determining pagination. Only options from the global context are returned. Note that this operation **only works for issue field select list options created in Jira or using operations from the \[Issue custom field options\](#api-group-Issue-custom-field-options) resource**, it cannot be used with issue field select list options created by Connect apps. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/customField/{fieldId}/option endpoint. ### [](#parameters-155)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Id

Number

The ID of the custom field. Note: This is the numeric part of the of the field ID. For example, for a field with the ID customfield\_10075 use 10075.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

1000

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-154)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-154)For Configurations - [Configurations](#Config) ### [](#throws-154)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Dashboard)Get All Dashboards `` Returns a list of dashboards owned by or shared with the user. The list may be filtered to include only favorite or owned dashboards. This operation can be accessed anonymously. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/dashboard endpoint. ### [](#parameters-156)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

filter

Enumeration, one of:

MY
FAVOURITE

The filter applied to the list of dashboards. Valid values are: * favourite Returns dashboards the user has marked as favorite. * my Returns dashboards owned by the user.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-155)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-155)For Configurations - [Configurations](#Config) ### [](#throws-155)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3DashboardById)Get Dashboard `` Returns a dashboard. This operation can be accessed anonymously. **Permissions required:** None. However, to get a dashboard, the dashboard must be shared with the user or the user must own it. Note, users with the **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) are considered owners of the System dashboard. The System dashboard is considered to be shared with all other users. This operation makes an HTTP GET request to the /rest/api/3/dashboard/{id} endpoint. ### [](#parameters-157)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the dashboard.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-156)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-156)For Configurations - [Configurations](#Config) ### [](#throws-156)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3DashboardItemsPropertiesByDashboardIdItemId)Get Dashboard Item Property Keys `` Returns the keys of all properties for a dashboard item. This operation can be accessed anonymously. **Permissions required:** The user must be the owner of the dashboard or be shared the dashboard. Note, users with the **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) are considered owners of the System dashboard. The System dashboard is considered to be shared with all other users. This operation makes an HTTP GET request to the /rest/api/3/dashboard/{dashboardId}/items/{itemId}/properties endpoint. ### [](#parameters-158)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Dashboard Id

String

The ID of the dashboard.

Item Id

String

The ID of the dashboard item.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-157)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-157)For Configurations - [Configurations](#Config) ### [](#throws-157)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3DashboardItemsPropertiesByDashboardIdItemIdPropertyKey)Get Dashboard Item Property `` Returns the key and value of a dashboard item property. A dashboard item enables an app to add user-specific information to a user dashboard. Dashboard items are exposed to users as gadgets that users can add to their dashboards. For more information on how users do this, see [Adding and customizing gadgets](https://support.atlassian.com/jira-software-cloud/docs/add-and-customize-gadgets/). When an app creates a dashboard item it registers a callback to receive the dashboard item ID. The callback fires whenever the item is rendered or, where the item is configurable, the user edits the item. The app then uses this resource to store the item’s content or configuration details. For more information on working with dashboard items, see [Building a dashboard item for a JIRA Connect add-on](https://developer.atlassian.com/server/jira/platform/guide-building-a-dashboard-item-for-a-jira-connect-add-on-33746254/) and the [Dashboard Item](https://developer.atlassian.com/cloud/jira/platform/modules/dashboard-item/) documentation. There is no resource to set or get dashboard items. This operation can be accessed anonymously. **Permissions required:** The user must be the owner of the dashboard or be shared the dashboard. Note, users with the **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) are considered owners of the System dashboard. The System dashboard is considered to be shared with all other users. This operation makes an HTTP GET request to the /rest/api/3/dashboard/{dashboardId}/items/{itemId}/properties/{propertyKey} endpoint. ### [](#parameters-159)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Dashboard Id

String

The ID of the dashboard.

Item Id

String

The ID of the dashboard item.

Property Key

String

The key of the dashboard item property.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-158)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-158)For Configurations - [Configurations](#Config) ### [](#throws-158)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3DashboardSearch)Get Dashboards Paginated `` Returns a paginated list of dashboards. This operation is similar to \[Get dashboards\](#api-rest-api-3-dashboard-get) except that the results can be refined to include dashboards that have specific attributes. For example, dashboards with a particular name. When multiple attributes are specified only filters matching all attributes are returned. This operation can be accessed anonymously. **Permissions required:** The following dashboards that match the query parameters are returned: - Dashboards owned by the user. Not returned for anonymous users. - Dashboards shared with a group that the user is a member of. Not returned for anonymous users. - Dashboards shared with a private project that the user can browse. Not returned for anonymous users. - Dashboards shared with a public project. - Dashboards shared with the public. This operation makes an HTTP GET request to the /rest/api/3/dashboard/search endpoint. ### [](#parameters-160)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Dashboard Name

String

String used to perform a case-insensitive partial match with name.

Account Id

String

User account ID used to return dashboards with the matching owner.accountId. This parameter cannot be used with the owner parameter.

owner

String

This parameter is deprecated because of privacy changes. Use accountId instead. See the migration guide for details. User name used to return dashboards with the matching owner.name. This parameter cannot be used with the accountId parameter.

groupname

String

Group name used to returns dashboards that are shared with a group that matches sharePermissions.group.name.

Project Id

Number

Project ID used to returns dashboards that are shared with a project that matches sharePermissions.project.id.

Order By

Enumeration, one of:

DESCRIPTION
FAVORITE_COUNT
ID
IS_FAVORITE
NAME
OWNER

Order the results by a field:

description Sorts by dashboard description. Note that this sort works independently of whether the expand to display the description field is in use.
favourite_count Sorts by dashboard popularity.
id Sorts by dashboard ID.
is_favourite Sorts by whether the dashboard is marked as a favorite.
name Sorts by dashboard name.
owner Sorts by dashboard owner name.

NAME

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

expand

String

Use expand to include additional information about the dashboard in the response. This parameter accepts a comma-separated list. Expand options include:

description Returns the description of the dashboard.
owner Returns the owner of the dashboard.
viewUrl Returns the URL that is used to view the dashboard.
favourite Returns isFavourite, an indicator of whether the user has set the dashboard as a favorite.
favouritedCount Returns popularity, a count of how many users have set this dashboard as a favorite.
sharePermissions Returns details of the share permissions defined for the dashboard.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-159)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-159)For Configurations - [Configurations](#Config) ### [](#throws-159)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Field)Get Fields `` Returns system and custom issue fields according to the following rules: - Fields that cannot be added to the issue navigator are always returned. - Fields that cannot be placed on an issue screen are always returned. - Fields that depend on global Jira settings are only returned if the setting is enabled. That is, timetracking fields, subtasks, votes, and watches. - For all other fields, this operation only returns the fields that the user has permission to view (that is, the field is used in at least one project that the user has **Browse Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for.) This operation can be accessed anonymously. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/field endpoint. ### [](#parameters-161)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-160)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-160)For Configurations - [Configurations](#Config) ### [](#throws-160)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FieldContextByFieldId)Get Contexts For Field `` Returns a paginated list of [contexts](https://support.atlassian.com/jira-cloud-administration/docs/configure-custom-field-context/) for a custom field. Contexts can be returned as follows: - With no other parameters set, all contexts. - By defining `id` only, all contexts from the list of IDs. - By defining `isAnyIssueType`, limit the list of contexts returned to either those that apply to all issue types (true) or those that apply to only a subset of issue types (false) - By defining `isGlobalContext`, limit the list of contexts return to either those that apply to all projects (global contexts) (true) or those that apply to only a subset of projects (false). **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/field/{fieldId}/context endpoint. ### [](#parameters-162)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Id

String

The ID of the custom field.

Is Any Issue Type

Boolean

Whether to return contexts that apply to all issue types.

false

Is Global Context

Boolean

Whether to return contexts that apply to all projects.

false

Context Id

Array of Number

The list of context IDs. To include multiple contexts, separate IDs with ampersand: contextId=10000&contextId=10001.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-161)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-161)For Configurations - [Configurations](#Config) ### [](#throws-161)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FieldContextDefaultValueByFieldId)Get Default Values `` Returns a paginated list of defaults for a custom field. The results can be filtered by `contextId`, otherwise all values are returned. If no defaults are set for a context, nothing is returned. The returned object depends on type of the custom field: - `CustomFieldContextDefaultValueSingleOption` (type `option.single`) for single choice select lists and radio buttons. - `CustomFieldContextDefaultValueMultipleOption` (type `option.multiple`) for multiple choice select lists and checkboxes. - `CustomFieldContextDefaultValueCascadingOption` (type `option.cascading`) for cascading select lists. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/field/{fieldId}/context/defaultValue endpoint. ### [](#parameters-163)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Id

String

The ID of the custom field.

Context Id

Array of Number

The IDs of the contexts.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-162)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-162)For Configurations - [Configurations](#Config) ### [](#throws-162)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FieldContextIssueTypeMappingByFieldId)Get Issue Type Mappings For Contexts `` Returns a paginated list of context to issue type mappings for a custom field. Mappings are returned for all contexts or a list of contexts. Mappings are ordered first by context ID and then by issue type ID. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/field/{fieldId}/context/issueTypeMapping endpoint. ### [](#parameters-164)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Id

String

The ID of the custom field.

Context Id

Array of Number

The ID of the context. To include multiple contexts, provide an ampersand-separated list. For example, contextId=10001&contextId=10002.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Iterable
Repeatable File Store Iterable
non-repeatable-iterable

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-163)Output

Type

Array of * Any

### [](#for-configurations-163)For Configurations - [Configurations](#Config) ### [](#throws-163)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FieldContextOptionByFieldIdContextId)Get Options For Context `` Returns a paginated list of all custom field option for a context. Options are returned first then cascading options, in the order they display in Jira. This operation works for custom field options created in Jira or the operations from this resource. To work with issue field select list options created for Connect apps use the \[Issue custom field options (apps)\](#api-group-issue-custom-field-options—apps-) operations. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/field/{fieldId}/context/{contextId}/option endpoint. ### [](#parameters-165)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Id

String

The ID of the custom field.

Context Id

Number

The ID of the context.

Option Id

Number

The ID of the option.

Only Options

Boolean

Whether only options are returned.

false

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

100

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-164)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-164)For Configurations - [Configurations](#Config) ### [](#throws-164)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FieldContextProjectmappingByFieldId)Get Project Context Mapping `` Returns a paginated list of context to project mappings for a custom field. The result can be filtered by `contextId`, or otherwise all mappings are returned. Invalid IDs are ignored. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/field/{fieldId}/context/projectmapping endpoint. ### [](#parameters-166)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Id

String

The ID of the custom field.

Context Id

Array of Number

The list of context IDs. To include multiple context, separate IDs with ampersand: contextId=10000&contextId=10001.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Iterable
Repeatable File Store Iterable
non-repeatable-iterable

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-165)Output

Type

Array of * Any

### [](#for-configurations-165)For Configurations - [Configurations](#Config) ### [](#throws-165)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FieldOptionByFieldKey)Get All Issue Field Options `` Returns a paginated list of all the options of a select list issue field. A select list issue field is a type of [issue field](https://developer.atlassian.com/cloud/jira/platform/modules/issue-field/) that enables a user to select a value from a list of options. Note that this operation **only works for issue field select list options added by Connect apps**, it cannot be used with issue field select list options created in Jira or using operations from the \[Issue custom field options\](#api-group-Issue-custom-field-options) resource. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) Jira permissions are not required for the app providing the field. This operation makes an HTTP GET request to the /rest/api/3/field/{fieldKey}/option endpoint. ### [](#parameters-167)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Key

String

The field key is specified in the following format: $(app-key)_\_$(field-key). For example, example-add-on\_\_example-issue-field. To determine the fieldKey value, do one of the following:

open the app’s plugin descriptor, then app-key is the key at the top and field-key is the key in the jiraIssueFields module. app-key can also be found in the app listing in the Atlassian Universal Plugin Manager.
run [Get fields](#api-rest-api-3-field-get) and in the field details the value is returned in key. For example, "key": "teams-add-on_team-issue-field"

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Iterable
Repeatable File Store Iterable
non-repeatable-iterable

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-166)Output

Type

Array of * Any

### [](#for-configurations-166)For Configurations - [Configurations](#Config) ### [](#throws-166)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FieldOptionByFieldKeyOptionId)Get Issue Field Option `` Returns an option from a select list issue field. Note that this operation **only works for issue field select list options added by Connect apps**, it cannot be used with issue field select list options created in Jira or using operations from the \[Issue custom field options\](#api-group-Issue-custom-field-options) resource. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) Jira permissions are not required for the app providing the field. This operation makes an HTTP GET request to the /rest/api/3/field/{fieldKey}/option/{optionId} endpoint. ### [](#parameters-168)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Key

String

The field key is specified in the following format: $(app-key)_\_$(field-key). For example, example-add-on\_\_example-issue-field. To determine the fieldKey value, do one of the following:

open the app’s plugin descriptor, then app-key is the key at the top and field-key is the key in the jiraIssueFields module. app-key can also be found in the app listing in the Atlassian Universal Plugin Manager.
run [Get fields](#api-rest-api-3-field-get) and in the field details the value is returned in key. For example, "key": "teams-add-on_team-issue-field"

Option Id

Number

The ID of the option to be returned.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-167)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-167)For Configurations - [Configurations](#Config) ### [](#throws-167)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FieldOptionSuggestionsEditByFieldKey)Get Selectable Issue Field Options `` Returns a paginated list of options for a select list issue field that can be viewed and selected by the user. Note that this operation **only works for issue field select list options added by Connect apps**, it cannot be used with issue field select list options created in Jira or using operations from the \[Issue custom field options\](#api-group-Issue-custom-field-options) resource. **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/field/{fieldKey}/option/suggestions/edit endpoint. ### [](#parameters-169)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Key

String

The field key is specified in the following format: $(app-key)_\_$(field-key). For example, example-add-on\_\_example-issue-field. To determine the fieldKey value, do one of the following:

open the app’s plugin descriptor, then app-key is the key at the top and field-key is the key in the jiraIssueFields module. app-key can also be found in the app listing in the Atlassian Universal Plugin Manager.
run [Get fields](#api-rest-api-3-field-get) and in the field details the value is returned in key. For example, "key": "teams-add-on_team-issue-field"

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Project Id

Number

Filters the results to options that are only available in the specified project.

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Iterable
Repeatable File Store Iterable
non-repeatable-iterable

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-168)Output

Type

Array of * Any

### [](#for-configurations-168)For Configurations - [Configurations](#Config) ### [](#throws-168)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FieldOptionSuggestionsSearchByFieldKey)Get Visible Issue Field Options `` Returns a paginated list of options for a select list issue field that can be viewed by the user. Note that this operation **only works for issue field select list options added by Connect apps**, it cannot be used with issue field select list options created in Jira or using operations from the \[Issue custom field options\](#api-group-Issue-custom-field-options) resource. **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/field/{fieldKey}/option/suggestions/search endpoint. ### [](#parameters-170)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Key

String

The field key is specified in the following format: $(app-key)_\_$(field-key). For example, example-add-on\_\_example-issue-field. To determine the fieldKey value, do one of the following:

open the app’s plugin descriptor, then app-key is the key at the top and field-key is the key in the jiraIssueFields module. app-key can also be found in the app listing in the Atlassian Universal Plugin Manager.
run [Get fields](#api-rest-api-3-field-get) and in the field details the value is returned in key. For example, "key": "teams-add-on_team-issue-field"

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Project Id

Number

Filters the results to options that are only available in the specified project.

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Iterable
Repeatable File Store Iterable
non-repeatable-iterable

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-169)Output

Type

Array of * Any

### [](#for-configurations-169)For Configurations - [Configurations](#Config) ### [](#throws-169)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FieldScreensByFieldId)Get Screens For Field `` Returns a paginated list of the screens a field is used in. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/field/{fieldId}/screens endpoint. ### [](#parameters-171)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Id

String

The ID of the field to return screens for.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

100

expand

String

Use expand to include additional information about screens in the response. This parameter accepts tab which returns details about the screen tabs the field is used in.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-170)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-170)For Configurations - [Configurations](#Config) ### [](#throws-170)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FieldSearch)Get Fields Paginated `` Returns a paginated list of fields for Classic Jira projects. The list can include: - all fields. - specific fields, by defining `id`. - fields that contain a string in the field name or description, by defining `query`. - specific fields that contain a string in the field name or description, by defining `id` and `query`. Only custom fields can be queried, `type` must be set to `custom`. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/field/search endpoint. ### [](#parameters-172)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

type

Array of Enumeration, one of:

CUSTOM
SYSTEM

The type of fields to search.

Array of String

The IDs of the custom fields to return or, where query is specified, filter.

query

String

String used to perform a case-insensitive partial match with field names or descriptions.

Order By

Enumeration, one of:

CONTEXTS_COUNT
LAST_USED
NAME
SCREENS_COUNT

Order the results by a field:

contextsCount Sorts by the number of contexts related to a field.
lastUsed Sorts by the date when the value of the field last changed.
name Sorts by the field name. * screensCount Sorts by the number of screens related to a field.

expand

String

Use expand to include additional information in the response. This parameter accepts a comma-separated list. Expand options include:

key Returns the key for each field.
lastUsed Returns the date when the value of the field last changed.
screensCount Returns the number of screens related to a field.
contextsCount Returns the number of contexts related to a field.
isLocked Returns information about whether the field is locked.

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Iterable
Repeatable File Store Iterable
non-repeatable-iterable

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-171)Output

Type

Array of * Any

### [](#for-configurations-171)For Configurations - [Configurations](#Config) ### [](#throws-171)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Fieldconfiguration)Get All Field Configurations `` Returns a paginated list of all field configurations. Only field configurations used in classic projects are returned. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/fieldconfiguration endpoint. ### [](#parameters-173)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Array of Number

The list of field configuration IDs. To include multiple IDs, provide an ampersand-separated list. For example, id=10000&id=10001.

Is Default

Boolean

If true returns the default field configuration only.

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-172)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-172)For Configurations - [Configurations](#Config) ### [](#throws-172)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FieldconfigurationFieldsById)Get Field Configuration Items `` Returns a paginated list of all fields for a configuration. Only the fields from configurations used in classic projects are returned. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/fieldconfiguration/{id}/fields endpoint. ### [](#parameters-174)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the field configuration.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-173)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-173)For Configurations - [Configurations](#Config) ### [](#throws-173)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Fieldconfigurationscheme)Get All Field Configuration Schemes `` Returns a paginated list of field configuration schemes. Only field configuration schemes used in classic projects are returned. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/fieldconfigurationscheme endpoint. ### [](#parameters-175)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Array of Number

The list of field configuration scheme IDs. To include multiple IDs, provide an ampersand-separated list. For example, id=10000&id=10001.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-174)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-174)For Configurations - [Configurations](#Config) ### [](#throws-174)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FieldconfigurationschemeMapping)Get Field Configuration Scheme Mappings `` Returns a paginated list of field configuration issue type items. Only items used in classic projects are returned. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/fieldconfigurationscheme/mapping endpoint. ### [](#parameters-176)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Field Configuration Scheme Id

Array of Number

The list of field configuration scheme IDs. To include multiple field configuration schemes separate IDs with ampersand: fieldConfigurationSchemeId=10000&fieldConfigurationSchemeId=10001.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-175)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-175)For Configurations - [Configurations](#Config) ### [](#throws-175)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FieldconfigurationschemeProject)Get Field Configuration Scheme Project Mapping `` Returns a paginated list of field configuration schemes and, for each scheme, a list of the projects that use it. The list is sorted by field configuration scheme ID. The first item contains the list of project IDs assigned to the default field configuration scheme. Only field configuration schemes used in classic projects are returned. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP GET request to the /rest/api/3/fieldconfigurationscheme/project endpoint. ### [](#parameters-177)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Project Id

Array of Number

The list of project IDs. To include multiple projects, separate IDs with ampersand: projectId=10000&projectId=10001.

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Iterable
Repeatable File Store Iterable
non-repeatable-iterable

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-176)Output

Type

Array of * Any

### [](#for-configurations-176)For Configurations - [Configurations](#Config) ### [](#throws-176)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FilterById)Get Filter `` Returns a filter. This operation can be accessed anonymously. **Permissions required:** None, however, the filter is only returned where it is: - owned by the user. - shared with a group that the user is a member of. - shared with a private project that the user has **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for. - shared with a public project. - shared with the public. This operation makes an HTTP GET request to the /rest/api/3/filter/{id} endpoint. ### [](#parameters-178)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the filter to return.

expand

String

Use expand to include additional information about filter in the response. This parameter accepts a comma-separated list. Expand options include:

sharedUsers Returns the users that the filter is shared with. This includes users that can browse projects that the filter is shared with. If you don’t specify sharedUsers, then the sharedUsers object is returned but it doesn’t list any users. The list of users returned is limited to 1000, to access additional users append [start-index:end-index] to the expand request. For example, to access the next 1000 users, use ?expand=sharedUsers[1001:2000].
subscriptions Returns the users that are subscribed to the filter. If you don’t specify subscriptions, the subscriptions object is returned but it doesn’t list any subscriptions. The list of subscriptions returned is limited to 1000, to access additional subscriptions append [start-index:end-index] to the expand request. For example, to access the next 1000 subscriptions, use ?expand=subscriptions[1001:2000].

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-177)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-177)For Configurations - [Configurations](#Config) ### [](#throws-177)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FilterColumnsById)Get Columns `` Returns the columns configured for a filter. The column configuration is used when the filter’s results are viewed in **List View** with the **Columns** set to **Filter**. This operation can be accessed anonymously. **Permissions required:** None, however, column details are only returned for: - filters owned by the user. - filters shared with a group that the user is a member of. - filters shared with a private project that the user has **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for. - filters shared with a public project. - filters shared with the public. This operation makes an HTTP GET request to the /rest/api/3/filter/{id}/columns endpoint. ### [](#parameters-179)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the filter.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-178)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-178)For Configurations - [Configurations](#Config) ### [](#throws-178)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FilterDefaultShareScope)Get Default Share Scope `` Returns the default sharing settings for new filters and dashboards for a user. **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/filter/defaultShareScope endpoint. ### [](#parameters-180)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-179)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-179)For Configurations - [Configurations](#Config) ### [](#throws-179)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FilterFavourite)Get Favourite Filters `` Returns the visible favorite filters of the user. This operation can be accessed anonymously. **Permissions required:** A favorite filter is only visible to the user where the filter is: - owned by the user. - shared with a group that the user is a member of. - shared with a private project that the user has **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for. - shared with a public project. - shared with the public. For example, if the user favorites a public filter that is subsequently made private that filter is not returned by this operation. This operation makes an HTTP GET request to the /rest/api/3/filter/favourite endpoint. ### [](#parameters-181)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

expand

String

Use expand to include additional information about filter in the response. This parameter accepts a comma-separated list. Expand options include:

sharedUsers Returns the users that the filter is shared with. This includes users that can browse projects that the filter is shared with. If you don’t specify sharedUsers, then the sharedUsers object is returned but it doesn’t list any users. The list of users returned is limited to 1000, to access additional users append [start-index:end-index] to the expand request. For example, to access the next 1000 users, use ?expand=sharedUsers[1001:2000].
subscriptions Returns the users that are subscribed to the filter. If you don’t specify subscriptions, the subscriptions object is returned but it doesn’t list any subscriptions. The list of subscriptions returned is limited to 1000, to access additional subscriptions append [start-index:end-index] to the expand request. For example, to access the next 1000 subscriptions, use ?expand=subscriptions[1001:2000].

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-180)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-180)For Configurations - [Configurations](#Config) ### [](#throws-180)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FilterMy)Get My Filters `` Returns the filters owned by the user. If `includeFavourites` is `true`, the user’s visible favorite filters are also returned. **Permissions required:** Permission to access Jira, however, a favorite filters is only visible to the user where the filter is: - owned by the user. - shared with a group that the user is a member of. - shared with a private project that the user has **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for. - shared with a public project. - shared with the public. For example, if the user favorites a public filter that is subsequently made private that filter is not returned by this operation. This operation makes an HTTP GET request to the /rest/api/3/filter/my endpoint. ### [](#parameters-182)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

expand

String

Use expand to include additional information about filter in the response. This parameter accepts a comma-separated list. Expand options include:

sharedUsers Returns the users that the filter is shared with. This includes users that can browse projects that the filter is shared with. If you don’t specify sharedUsers, then the sharedUsers object is returned but it doesn’t list any users. The list of users returned is limited to 1000, to access additional users append [start-index:end-index] to the expand request. For example, to access the next 1000 users, use ?expand=sharedUsers[1001:2000].
subscriptions Returns the users that are subscribed to the filter. If you don’t specify subscriptions, the subscriptions object is returned but it doesn’t list any subscriptions. The list of subscriptions returned is limited to 1000, to access additional subscriptions append [start-index:end-index] to the expand request. For example, to access the next 1000 subscriptions, use ?expand=subscriptions[1001:2000].

Include Favourites

Boolean

Include the user’s favorite filters in the response.

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-181)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-181)For Configurations - [Configurations](#Config) ### [](#throws-181)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FilterPermissionById)Get Share Permissions `` Returns the share permissions for a filter. A filter can be shared with groups, projects, all logged-in users, or the public. Sharing with all logged-in users or the public is known as a global share permission. This operation can be accessed anonymously. **Permissions required:** None, however, share permissions are only returned for: - filters owned by the user. - filters shared with a group that the user is a member of. - filters shared with a private project that the user has **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for. - filters shared with a public project. - filters shared with the public. This operation makes an HTTP GET request to the /rest/api/3/filter/{id}/permission endpoint. ### [](#parameters-183)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the filter.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-182)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-182)For Configurations - [Configurations](#Config) ### [](#throws-182)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FilterPermissionByIdPermissionId)Get Share Permission `` Returns a share permission for a filter. A filter can be shared with groups, projects, all logged-in users, or the public. Sharing with all logged-in users or the public is known as a global share permission. This operation can be accessed anonymously. **Permissions required:** None, however, a share permission is only returned for: - filters owned by the user. - filters shared with a group that the user is a member of. - filters shared with a private project that the user has **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for. - filters shared with a public project. - filters shared with the public. This operation makes an HTTP GET request to the /rest/api/3/filter/{id}/permission/{permissionId} endpoint. ### [](#parameters-184)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the filter.

Permission Id

Number

The ID of the share permission.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-183)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-183)For Configurations - [Configurations](#Config) ### [](#throws-183)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3FilterSearch)Get Filters Paginated `` Returns a paginated list of filters. Use this operation to get: - specific filters, by defining `id` only. - filters that match all of the specified attributes. For example, all filters for a user with a particular word in their name. When multiple attributes are specified only filters matching all attributes are returned. This operation can be accessed anonymously. **Permissions required:** None, however, only the following filters that match the query parameters are returned: - filters owned by the user. - filters shared with a group that the user is a member of. - filters shared with a private project that the user has **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for. - filters shared with a public project. - filters shared with the public. This operation makes an HTTP GET request to the /rest/api/3/filter/search endpoint. ### [](#parameters-185)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Filter Name

String

String used to perform a case-insensitive partial match with name.

Account Id

String

User account ID used to return filters with the matching owner.accountId. This parameter cannot be used with owner.

owner

String

This parameter is deprecated because of privacy changes. Use accountId instead. See the migration guide for details. User name used to return filters with the matching owner.name. This parameter cannot be used with accountId.

groupname

String

Group name used to returns filters that are shared with a group that matches sharePermissions.group.groupname.

Project Id

Number

Project ID used to returns filters that are shared with a project that matches sharePermissions.project.id.

Array of Number

The list of filter IDs. To include multiple IDs, provide an ampersand-separated list. For example, id=10000&id=10001.

Order By

Enumeration, one of:

DESCRIPTION
FAVORITE_COUNT
ID
IS_FAVORITE
NAME
OWNER

Order the results by a field:

description Sorts by filter description. Note that this sorting works independently of whether the expand to display the description field is in use.
favourite_count Sorts by the count of how many users have this filter as a favorite.
is_favourite Sorts by whether the filter is marked as a favorite.
id Sorts by filter ID.
name Sorts by filter name.
owner Sorts by the ID of the filter owner.

NAME

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

expand

String

Use expand to include additional information about filter in the response. This parameter accepts a comma-separated list. Expand options include:

description Returns the description of the filter.
favourite Returns an indicator of whether the user has set the filter as a favorite.
favouritedCount Returns a count of how many users have set this filter as a favorite.
jql Returns the JQL query that the filter uses.
owner Returns the owner of the filter.
searchUrl Returns a URL to perform the filter’s JQL query.
sharePermissions Returns the share permissions defined for the filter.
subscriptions Returns the users that are subscribed to the filter.
viewUrl Returns a URL to view the filter.

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Iterable
Repeatable File Store Iterable
non-repeatable-iterable

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-184)Output

Type

Array of * Any

### [](#for-configurations-184)For Configurations - [Configurations](#Config) ### [](#throws-184)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3GroupBulk)Bulk Get Groups `` Returns a paginated list of groups. **Permissions required:** **Browse users and groups** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/group/bulk endpoint. ### [](#parameters-186)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Group Id

Array of String

The ID of a group. To specify multiple IDs, pass multiple groupId parameters. For example, groupId=5b10a2844c20165700ede21g&groupId=5b10ac8d82e05b22cc7d4ef5.

Group Name

Array of String

The name of a group. To specify multiple names, pass multiple groupName parameters. For example, groupName=administrators&groupName=jira-software-users.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-185)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-185)For Configurations - [Configurations](#Config) ### [](#throws-185)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3GroupMember)Get Users From Group `` Returns a paginated list of all users in a group. Note that users are ordered by username, however the username is not returned in the results due to privacy reasons. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/group/member endpoint. ### [](#parameters-187)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

groupname

String

The name of the group.

Include Inactive Users

Boolean

Include inactive users.

false

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-186)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-186)For Configurations - [Configurations](#Config) ### [](#throws-186)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3GroupsPicker)Find Groups `` Returns a list of groups whose names contain a query string. A list of group names can be provided to exclude groups from the results. The primary use case for this resource is to populate a group picker suggestions list. To this end, the returned object includes the `html` field where the matched query term is highlighted in the group name with the HTML strong tag. Also, the groups list is wrapped in a response object that contains a header for use in the picker, specifically **Showing X of Y matching groups**. The list returns with the groups sorted. If no groups match the list criteria, an empty list is returned. This operation can be accessed anonymously. **Permissions required:** **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg). Anonymous calls and calls by users without the required permission return an empty list. This operation makes an HTTP GET request to the /rest/api/3/groups/picker endpoint. ### [](#parameters-188)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Account Id

String

This parameter is deprecated, setting it does not affect the results. To find groups containing a particular user, use [Get user groups](#api-rest-api-3-user-groups-get).

query

String

The string to find in group names.

exclude

Array of String

A group to exclude from the result. To exclude multiple groups, provide an ampersand-separated list. For example, exclude=group1&exclude=group2.

Max Results

Number

The maximum number of groups to return. The maximum number of groups that can be returned is limited by the system property jira.ajax.autocomplete.limit.

User Name

String

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-187)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-187)For Configurations - [Configurations](#Config) ### [](#throws-187)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Groupuserpicker)Find Users And Groups `` Returns a list of users and groups matching a string. The string is used: - for users, to find a case-insensitive match with display name and e-mail address. Note that if a user has hidden their email address in their user profile, partial matches of the email address will not find the user. An exact match is required. - for groups, to find a case-sensitive match with group name. For example, if the string **tin** is used, records with the display name **Tina**, email address **sarah@tinplatetraining.com**, and the group **accounting** would be returned. Optionally, the search can be refined to: - the projects and issue types associated with a custom field, such as a user picker. The search can then be further refined to return only users and groups that have permission to view specific: - projects. - issue types. If multiple projects or issue types are specified, they must be a subset of those enabled for the custom field or no results are returned. For example, if a field is enabled for projects A, B, and C then the search could be limited to projects B and C. However, if the search is limited to projects B and D, nothing is returned. The primary use case for this resource is to populate a picker field suggestion list with users or groups. To this end, the returned object includes an `html` field for each list. This field highlights the matched query term in the item name with the HTML strong tag. Also, each list is wrapped in a response object that contains a header for use in a picker, specifically **Showing X of Y matching groups**. This operation can be accessed anonymously. **Permissions required:** **Browse users and groups** [global permission](https://confluence.atlassian.com/x/yodKLg) This operation makes an HTTP GET request to the /rest/api/3/groupuserpicker endpoint. ### [](#parameters-189)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

query

String

The search string.

Max Results

Number

The maximum number of items to return in each list.

Show Avatar

Boolean

Whether the user avatar should be returned. If an invalid value is provided, the default value is used.

false

Field Id

String

The custom field ID of the field this request is for.

Project Id

Array of String

The ID of a project that returned users and groups must have permission to view. To include multiple projects, provide an ampersand-separated list. For example, projectId=10000&projectId=10001. This parameter is only used when fieldId is present.

Issue Type Id

Array of String

The ID of an issue type that returned users and groups must have permission to view. To include multiple issue types, provide an ampersand-separated list. For example, issueTypeId=10000&issueTypeId=10001. Special values, such as -1 (all standard issue types) and -2 (all subtask issue types), are supported. This parameter is only used when fieldId is present.

Avatar Size

Enumeration, one of:

XSMALL
XSMALL2X
XSMALL3X
SMALL
SMALL2X
SMALL3X
MEDIUM
MEDIUM2X
MEDIUM3X
LARGE
LARGE2X
LARGE3X
XLARGE
XLARGE2X
XLARGE3X
XXLARGE
XXLARGE2X
XXLARGE3X
XXXLARGE
XXXLARGE2X
XXXLARGE3X

The size of the avatar to return. If an invalid value is provided, the default value is used.

XSMALL

Case Insensitive

Boolean

Whether the search for groups should be case insensitive.

false

Exclude Connect Addons

Boolean

Whether Connect app users and groups should be excluded from the search results. If an invalid value is provided, the default value is used.

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-188)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-188)For Configurations - [Configurations](#Config) ### [](#throws-188)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssueByIssueIdOrKey)Get Issue `` Returns the details for an issue. The issue is identified by its ID or key, however, if the identifier doesn’t match an issue, a case-insensitive search and check for moved issues is performed. If a matching issue is found its details are returned, a 302 or other redirect is **not** returned. The issue key returned in the response is the key of the issue found. This operation can be accessed anonymously. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP GET request to the /rest/api/3/issue/{issueIdOrKey} endpoint. ### [](#parameters-190)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

fields

Array of String

A list of fields to return for the issue. This parameter accepts a comma-separated list. Use it to retrieve a subset of fields. Allowed values:

*all Returns all fields.
*navigable Returns navigable fields.
Any issue field, prefixed with a minus to exclude.

Examples:

summary,comment Returns only the summary and comments fields.
-description Returns all (default) fields except description.
*navigable,-comment Returns all navigable fields except comment.

This parameter can be specified multiple times, for example, fields=field1,field2& fields=field3. Note: All fields are returned by default. This differs from [Search for issues using JQL (GET)](#api-rest-api-3-search-get) and [Search for issues using JQL (POST)](#api-rest-api-3-search-post) where the default is all navigable fields.

Fields By Keys

Boolean

Whether fields in fields are referenced by keys rather than IDs. This parameter is useful where fields have been added by a connect app and a field’s key may differ from its ID.

false

expand

String

Use expand to include additional information about the issues in the response. This parameter accepts a comma-separated list. Expand options include:

renderedFields Returns field values rendered in HTML format.
names Returns the display name of each field.
schema Returns the schema describing a field type.
transitions Returns all possible transitions for the issue.
editmeta Returns information about how each field can be edited.
changelog Returns a list of recent updates to an issue, sorted by date, starting from the most recent.
versionedRepresentations Returns a JSON array for each version of a field’s value, with the highest number representing the most recent version. Note: When included in the request, the fields parameter is ignored.

properties

Array of String

A list of issue properties to return for the issue. This parameter accepts a comma-separated list. Allowed values:

*all Returns all issue properties.
Any issue property key, prefixed with a minus to exclude.

Examples:

*all Returns all properties.
*all,-prop1 Returns all properties except prop1.
prop1,prop2 Returns prop1 and prop2 properties.

This parameter can be specified multiple times, for example, properties=prop1,prop2& properties=prop3.

Update History

Boolean

Whether the project in which the issue is created is added to the user’s Recently viewed project list, as shown under Projects in Jira. This also populates the [JQL issues search](#api-rest-api-3-search-get) lastViewed field.

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-189)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-189)For Configurations - [Configurations](#Config) ### [](#throws-189)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssueChangelogByIssueIdOrKey)Get Change Logs `` Returns a paginated list of all changelogs for an issue sorted by date, starting from the oldest. This operation can be accessed anonymously. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP GET request to the /rest/api/3/issue/{issueIdOrKey}/changelog endpoint. ### [](#parameters-191)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

100

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Iterable
Repeatable File Store Iterable
non-repeatable-iterable

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-190)Output

Type

Array of * Any

### [](#for-configurations-190)For Configurations - [Configurations](#Config) ### [](#throws-190)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssueCommentByIssueIdOrKey)Get Comments `` Returns all comments for an issue. This operation can be accessed anonymously. **Permissions required:** Comments are included in the response where the user has: - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project containing the comment. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. - If the comment has visibility restrictions, belongs to the group or has the role visibility is role visibility is restricted to. This operation makes an HTTP GET request to the /rest/api/3/issue/{issueIdOrKey}/comment endpoint. ### [](#parameters-192)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Order By

Enumeration, one of:

CREATED

Order the results by a field. Accepts created to sort comments by their created date.

expand

String

Use expand to include additional information about comments in the response. This parameter accepts renderedBody, which returns the comment body rendered in HTML.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-191)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-191)For Configurations - [Configurations](#Config) ### [](#throws-191)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssueCommentByIssueIdOrKeyId)Get Comment `` Returns a comment. This operation can be accessed anonymously. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project containing the comment. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. - If the comment has visibility restrictions, the user belongs to the group or has the role visibility is restricted to. This operation makes an HTTP GET request to the /rest/api/3/issue/{issueIdOrKey}/comment/{id} endpoint. ### [](#parameters-193)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

String

The ID of the comment.

expand

String

Use expand to include additional information about comments in the response. This parameter accepts renderedBody, which returns the comment body rendered in HTML.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-192)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-192)For Configurations - [Configurations](#Config) ### [](#throws-192)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssueCreatemeta)Get Create Issue Meta `` Returns details of projects, issue types within projects, and, when requested, the create screen fields for each issue type for the user. Use the information to populate the requests in \[ Create issue\](#api-rest-api-3-issue-post) and \[Create issues\](#api-rest-api-3-issue-bulk-post). The request can be restricted to specific projects or issue types using the query parameters. The response will contain information for the valid projects, issue types, or project and issue type combinations requested. Note that invalid project, issue type, or project and issue type combinations do not generate errors. This operation can be accessed anonymously. **Permissions required:** **Create issues** [project permission](https://confluence.atlassian.com/x/yodKLg) in the requested projects. This operation makes an HTTP GET request to the /rest/api/3/issue/createmeta endpoint. ### [](#parameters-194)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Ids

Array of String

List of project IDs. This parameter accepts a comma-separated list. Multiple project IDs can also be provided using an ampersand-separated list. For example, projectIds=10000,10001&projectIds=10020,10021. This parameter may be provided with projectKeys.

Project Keys

Array of String

List of project keys. This parameter accepts a comma-separated list. Multiple project keys can also be provided using an ampersand-separated list. For example, projectKeys=proj1,proj2&projectKeys=proj3. This parameter may be provided with projectIds.

Issuetype Ids

Array of String

List of issue type IDs. This parameter accepts a comma-separated list. Multiple issue type IDs can also be provided using an ampersand-separated list. For example, issuetypeIds=10000,10001&issuetypeIds=10020,10021. This parameter may be provided with issuetypeNames.

Issuetype Names

Array of String

List of issue type names. This parameter accepts a comma-separated list. Multiple issue type names can also be provided using an ampersand-separated list. For example, issuetypeNames=name1,name2&issuetypeNames=name3. This parameter may be provided with issuetypeIds.

expand

String

Use expand to include additional information about issue metadata in the response. This parameter accepts projects.issuetypes.fields, which returns information about the fields in the issue creation screen for each issue type. Fields hidden from the screen are not returned. Use the information to populate the fields and update fields in [Create issue](#api-rest-api-3-issue-post) and [Create issues](#api-rest-api-3-issue-bulk-post).

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-193)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-193)For Configurations - [Configurations](#Config) ### [](#throws-193)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssueEditmetaByIssueIdOrKey)Get Edit Issue Meta `` Returns the edit screen fields for an issue that are visible to and editable by the user. Use the information to populate the requests in \[Edit issue\](#api-rest-api-3-issue-issueIdOrKey-put). Connect app users with admin permissions (from user permissions and app scopes) can return additional details using: - `overrideScreenSecurity` Returns hidden fields. - `overrideEditableFlag` Returns uneditable fields. For example, where an issue has a workflow status of closed none of its fields are editable. This operation can be accessed anonymously. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. Note: For any fields to be editable the user must have the **Edit issues** [project permission](https://confluence.atlassian.com/x/yodKLg) for the issue. This operation makes an HTTP GET request to the /rest/api/3/issue/{issueIdOrKey}/editmeta endpoint. ### [](#parameters-195)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Override Screen Security

Boolean

Whether hidden fields should be returned. Available to connect app users with admin permissions.

false

Override Editable Flag

Boolean

Whether non-editable fields should be returned. Available to connect app users with admin permissions.

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-194)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-194)For Configurations - [Configurations](#Config) ### [](#throws-194)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssueLinkByLinkId)Get Issue Link `` Returns an issue link. This operation can be accessed anonymously. **Permissions required:** - **Browse project** [project permission](https://confluence.atlassian.com/x/yodKLg) for all the projects containing the linked issues. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, permission to view both of the issues. This operation makes an HTTP GET request to the /rest/api/3/issueLink/{linkId} endpoint. ### [](#parameters-196)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Link Id

String

The ID of the issue link.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-195)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-195)For Configurations - [Configurations](#Config) ### [](#throws-195)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssueLinkType)Get Issue Link Types `` Returns a list of all issue link types. To use this operation, the site must have [issue linking](https://confluence.atlassian.com/x/yoXKM) enabled. This operation can be accessed anonymously. **Permissions required:** **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for a project in the site. This operation makes an HTTP GET request to the /rest/api/3/issueLinkType endpoint. ### [](#parameters-197)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-196)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-196)For Configurations - [Configurations](#Config) ### [](#throws-196)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssueLinkTypeByIssueLinkTypeId)Get Issue Link Type `` Returns an issue link type. To use this operation, the site must have [issue linking](https://confluence.atlassian.com/x/yoXKM) enabled. This operation can be accessed anonymously. **Permissions required:** **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for a project in the site. This operation makes an HTTP GET request to the /rest/api/3/issueLinkType/{issueLinkTypeId} endpoint. ### [](#parameters-198)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Link Type Id

String

The ID of the issue link type.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-197)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-197)For Configurations - [Configurations](#Config) ### [](#throws-197)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssuePicker)Get Issue Picker Resource `` Returns lists of issues matching a query string. Use this resource to provide auto-completion suggestions when the user is looking for an issue using a word or string. This operation returns two lists: - `History Search` which includes issues from the user’s history of created, edited, or viewed issues that contain the string in the `query` parameter. - `Current Search` which includes issues that match the JQL expression in `currentJQL` and contain the string in the `query` parameter. This operation can be accessed anonymously. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/issue/picker endpoint. ### [](#parameters-199)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

query

String

A string to match against text fields in the issue such as title, description, or comments.

Current JQL

String

A JQL query defining a list of issues to search for the query term. Note that username and userkey cannot be used as search terms for this parameter, due to privacy reasons. Use accountId instead.

Current Issue Key

String

The key of an issue to exclude from search results. For example, the issue the user is viewing when they perform this query.

Current Project Id

String

The ID of a project that suggested issues must belong to.

Show Sub Tasks

Boolean

Indicate whether to include subtasks in the suggestions list.

false

Show Sub Task Parent

Boolean

When currentIssueKey is a subtask, whether to include the parent issue in the suggestions if it matches the query.

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-198)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-198)For Configurations - [Configurations](#Config) ### [](#throws-198)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssuePropertiesByIssueIdOrKey)Get Issue Property Keys `` Returns the URLs and keys of an issue’s properties. This operation can be accessed anonymously. **Permissions required:** Property details are only returned where the user has: - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project containing the issue. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP GET request to the /rest/api/3/issue/{issueIdOrKey}/properties endpoint. ### [](#parameters-200)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The key or ID of the issue.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-199)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-199)For Configurations - [Configurations](#Config) ### [](#throws-199)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssuePropertiesByIssueIdOrKeyPropertyKey)Get Issue Property `` Returns the key and value of an issue’s property. This operation can be accessed anonymously. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project containing the issue. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP GET request to the /rest/api/3/issue/{issueIdOrKey}/properties/{propertyKey} endpoint. ### [](#parameters-201)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The key or ID of the issue.

Property Key

String

The key of the property.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-200)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-200)For Configurations - [Configurations](#Config) ### [](#throws-200)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssueRemotelinkByIssueIdOrKey)Get Remote Issue Links `` Returns the remote issue links for an issue. When a remote issue link global ID is provided the record with that global ID is returned, otherwise all remote issue links are returned. Where a global ID includes reserved URL characters these must be escaped in the request. For example, pass `system=http://www.mycompany.com/support&id=1` as `system%3Dhttp%3A%2F%2Fwww.mycompany.com%2Fsupport%26id%3D1`. This operation requires [issue linking to be active](https://confluence.atlassian.com/x/yoXKM). This operation can be accessed anonymously. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP GET request to the /rest/api/3/issue/{issueIdOrKey}/remotelink endpoint. ### [](#parameters-202)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Global Id

String

The global ID of the remote issue link.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-201)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-201)For Configurations - [Configurations](#Config) ### [](#throws-201)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssueRemotelinkByIssueIdOrKeyLinkId)Get Remote Issue Link By Id `` Returns a remote issue link for an issue. This operation requires [issue linking to be active](https://confluence.atlassian.com/x/yoXKM). This operation can be accessed anonymously. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP GET request to the /rest/api/3/issue/{issueIdOrKey}/remotelink/{linkId} endpoint. ### [](#parameters-203)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Link Id

String

The ID of the remote issue link.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-202)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-202)For Configurations - [Configurations](#Config) ### [](#throws-202)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssueTransitionsByIssueIdOrKey)Get Transitions `` Returns either all transitions or a transition that can be performed by the user on an issue, based on the issue’s status. Note, if a request is made for a transition that does not exist or cannot be performed on the issue, given its status, the response will return any empty transitions list. This operation can be accessed anonymously. **Permissions required:** A list or transition is returned only when the user has: - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. However, if the user does not have the **Transition issues** [project permission](https://confluence.atlassian.com/x/yodKLg) the response will not list any transitions. This operation makes an HTTP GET request to the /rest/api/3/issue/{issueIdOrKey}/transitions endpoint. ### [](#parameters-204)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

expand

String

Use expand to include additional information about transitions in the response. This parameter accepts transitions.fields, which returns information about the fields in the transition screen for each transition. Fields hidden from the screen are not returned. Use this information to populate the fields and update fields in [Transition issue](#api-rest-api-3-issue-issueIdOrKey-transitions-post).

Transition Id

String

The ID of the transition.

Skip Remote Only Condition

Boolean

Whether transitions with the condition Hide From User Condition are included in the response.

false

Include Unavailable Transitions

Boolean

Whether details of transitions that fail a condition are included in the response

false

Sort By Ops Bar And Status

Boolean

Whether the transitions are sorted by ops-bar sequence value first then category order (Todo, In Progress, Done) or only by ops-bar sequence value.

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-203)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-203)For Configurations - [Configurations](#Config) ### [](#throws-203)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssueVotesByIssueIdOrKey)Get Votes `` Returns details about the votes on an issue. This operation requires the **Allow users to vote on issues** option to be **ON**. This option is set in General configuration for Jira. See [Configuring Jira application options](https://confluence.atlassian.com/x/uYXKM) for details. This operation can be accessed anonymously. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is ini - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. Note that users with the necessary permissions for this operation but without the **View voters and watchers** project permissions are not returned details in the `voters` field. This operation makes an HTTP GET request to the /rest/api/3/issue/{issueIdOrKey}/votes endpoint. ### [](#parameters-205)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-204)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-204)For Configurations - [Configurations](#Config) ### [](#throws-204)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssueWatchersByIssueIdOrKey)Get Issue Watchers `` Returns the watchers for an issue. This operation requires the **Allow users to watch issues** option to be **ON**. This option is set in General configuration for Jira. See [Configuring Jira application options](https://confluence.atlassian.com/x/uYXKM) for details. This operation can be accessed anonymously. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is ini - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. - To see details of users on the watchlist other than themselves, **View voters and watchers** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. This operation makes an HTTP GET request to the /rest/api/3/issue/{issueIdOrKey}/watchers endpoint. ### [](#parameters-206)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-205)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-205)For Configurations - [Configurations](#Config) ### [](#throws-205)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssueWorklogByIssueIdOrKey)Get Issue Worklog `` Returns worklogs for an issue, starting from the oldest worklog or from the worklog started on or after a date and time. Time tracking must be enabled in Jira, otherwise this operation returns an error. For more information, see [Configuring time tracking](https://confluence.atlassian.com/x/qoXKM). This operation can be accessed anonymously. **Permissions required:** Workloads are only returned where the user has: - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. - If the worklog has visibility restrictions, belongs to the group or has the role visibility is restricted to. This operation makes an HTTP GET request to the /rest/api/3/issue/{issueIdOrKey}/worklog endpoint. ### [](#parameters-207)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

1048576

Started After

Number

The worklog start date and time, as a UNIX timestamp in milliseconds, after which worklogs are returned.

expand

String

Use expand to include additional information about worklogs in the response. This parameter accepts`properties`, which returns worklog properties.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-206)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-206)For Configurations - [Configurations](#Config) ### [](#throws-206)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssueWorklogByIssueIdOrKeyId)Get Worklog `` Returns a worklog. Time tracking must be enabled in Jira, otherwise this operation returns an error. For more information, see [Configuring time tracking](https://confluence.atlassian.com/x/qoXKM). This operation can be accessed anonymously. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. - If the worklog has visibility restrictions, belongs to the group or has the role visibility is restricted to. This operation makes an HTTP GET request to the /rest/api/3/issue/{issueIdOrKey}/worklog/{id} endpoint. ### [](#parameters-208)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

String

The ID of the worklog.

expand

String

Use expand to include additional information about work logs in the response. This parameter accepts properties, which returns worklog properties.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-207)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-207)For Configurations - [Configurations](#Config) ### [](#throws-207)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssueWorklogPropertiesByIssueIdOrKeyWorklogId)Get Worklog Property Keys `` Returns the keys of all properties for a worklog. This operation can be accessed anonymously. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. - If the worklog has visibility restrictions, belongs to the group or has the role visibility is restricted to. This operation makes an HTTP GET request to the /rest/api/3/issue/{issueIdOrKey}/worklog/{worklogId}/properties endpoint. ### [](#parameters-209)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Worklog Id

String

The ID of the worklog.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-208)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-208)For Configurations - [Configurations](#Config) ### [](#throws-208)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssueWorklogPropertiesByIssueIdOrKeyWorklogIdPropertyKey)Get Worklog Property `` Returns the value of a worklog property. This operation can be accessed anonymously. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. - If the worklog has visibility restrictions, belongs to the group or has the role visibility is restricted to. This operation makes an HTTP GET request to the /rest/api/3/issue/{issueIdOrKey}/worklog/{worklogId}/properties/{propertyKey} endpoint. ### [](#parameters-210)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Worklog Id

String

The ID of the worklog.

Property Key

String

The key of the property.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-209)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-209)For Configurations - [Configurations](#Config) ### [](#throws-209)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Issuesecurityschemes)Get Issue Security Schemes `` Returns all [issue security schemes](https://confluence.atlassian.com/x/J4lKLg). **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/issuesecurityschemes endpoint. ### [](#parameters-211)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-210)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-210)For Configurations - [Configurations](#Config) ### [](#throws-210)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssuesecurityschemesById)Get Issue Security Scheme `` Returns an issue security scheme along with its security levels. **Permissions required:** - **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). - **Administer Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for a project that uses the requested issue security scheme. This operation makes an HTTP GET request to the /rest/api/3/issuesecurityschemes/{id} endpoint. ### [](#parameters-212)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the issue security scheme. Use the [Get issue security schemes](#api-rest-api-3-issuesecurityschemes-get) operation to get a list of issue security scheme IDs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-211)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-211)For Configurations - [Configurations](#Config) ### [](#throws-211)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssuesecurityschemesMembersByIssueSecuritySchemeId)Get Issue Security Level Members `` Returns issue security level members. Only issue security level members in context of classic projects are returned. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/issuesecurityschemes/{issueSecuritySchemeId}/members endpoint. ### [](#parameters-213)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Security Scheme Id

Number

The ID of the issue security scheme. Use the [Get issue security schemes](#api-rest-api-3-issuesecurityschemes-get) operation to get a list of issue security scheme IDs.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Issue Security Level Id

Array of Number

The list of issue security level IDs. To include multiple issue security levels separate IDs with ampersand: issueSecurityLevelId=10000&issueSecurityLevelId=10001.

expand

String

Use expand to include additional information in the response. This parameter accepts a comma-separated list. Expand options include: * all Returns all expandable information. * field Returns information about the custom field granted the permission. * group Returns information about the group that is granted the permission. * projectRole Returns information about the project role granted the permission. * user Returns information about the user who is granted the permission.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-212)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-212)For Configurations - [Configurations](#Config) ### [](#throws-212)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Issuetype)Get Issue All Types `` Returns all issue types. This operation can be accessed anonymously. **Permissions required:** Issue types are only returned as follows: - if the user has the **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg), all issue types are returned. - if the user has the **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for one or more projects, the issue types associated with the projects the user has permission to browse are returned. This operation makes an HTTP GET request to the /rest/api/3/issuetype endpoint. ### [](#parameters-214)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-213)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-213)For Configurations - [Configurations](#Config) ### [](#throws-213)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssuetypeAlternativesById)Get Alternative Issue Types `` Returns a list of issue types that can be used to replace the issue type. The alternative issue types are those assigned to the same workflow scheme, field configuration scheme, and screen scheme. This operation can be accessed anonymously. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/issuetype/{id}/alternatives endpoint. ### [](#parameters-215)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the issue type.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-214)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-214)For Configurations - [Configurations](#Config) ### [](#throws-214)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssuetypeById)Get Issue Type `` Returns an issue type. This operation can be accessed anonymously. **Permissions required:** **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) in a project the issue type is associated with or **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP GET request to the /rest/api/3/issuetype/{id} endpoint. ### [](#parameters-216)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the issue type.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-215)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-215)For Configurations - [Configurations](#Config) ### [](#throws-215)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssuetypePropertiesByIssueTypeId)Get Issue Type Property Keys `` Returns all the [issue type property](https://developer.atlassian.com/cloud/jira/platform/storing-data-with-entity-properties/) keys of the issue type. This operation can be accessed anonymously. **Permissions required:** - **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) to get the property keys of any issue type. - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) to get the property keys of any issue types associated with the projects the user has permission to browse. This operation makes an HTTP GET request to the /rest/api/3/issuetype/{issueTypeId}/properties endpoint. ### [](#parameters-217)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Type Id

String

The ID of the issue type.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-216)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-216)For Configurations - [Configurations](#Config) ### [](#throws-216)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssuetypePropertiesByIssueTypeIdPropertyKey)Get Issue Type Property `` Returns the key and value of the [issue type property](https://developer.atlassian.com/cloud/jira/platform/storing-data-with-entity-properties/). This operation can be accessed anonymously. **Permissions required:** - **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) to get the details of any issue type. - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) to get the details of any issue types associated with the projects the user has permission to browse. This operation makes an HTTP GET request to the /rest/api/3/issuetype/{issueTypeId}/properties/{propertyKey} endpoint. ### [](#parameters-218)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Type Id

String

The ID of the issue type.

Property Key

String

The key of the property. Use [Get issue type property keys](#api-rest-api-3-issuetype-issueTypeId-properties-get) to get a list of all issue type property keys.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-217)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-217)For Configurations - [Configurations](#Config) ### [](#throws-217)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Issuetypescheme)Get All Issue Type Schemes `` Returns a paginated list of issue type schemes. Only issue type schemes used in classic projects are returned. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/issuetypescheme endpoint. ### [](#parameters-219)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Array of Number

The list of issue type schemes IDs. To include multiple IDs, provide an ampersand-separated list. For example, id=10000&id=10001.

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Iterable
Repeatable File Store Iterable
non-repeatable-iterable

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-218)Output

Type

Array of * Any

### [](#for-configurations-218)For Configurations - [Configurations](#Config) ### [](#throws-218)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssuetypeschemeMapping)Get Issue Type Schemes Mapping `` Returns a paginated list of issue type scheme items. Only issue type scheme items used in classic projects are returned. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/issuetypescheme/mapping endpoint. ### [](#parameters-220)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Issue Type Scheme Id

Array of Number

The list of issue type scheme IDs. To include multiple IDs, provide an ampersand-separated list. For example, issueTypeSchemeId=10000&issueTypeSchemeId=10001.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-219)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-219)For Configurations - [Configurations](#Config) ### [](#throws-219)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssuetypeschemeProject)Get Issue Type Scheme For Projects `` Returns a paginated list of issue type schemes and, for each issue type scheme, a list of the projects that use it. Only issue type schemes used in classic projects are returned. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP GET request to the /rest/api/3/issuetypescheme/project endpoint. ### [](#parameters-221)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Project Id

Array of Number

The list of project IDs. To include multiple project IDs, provide an ampersand-separated list. For example, projectId=10000&projectId=10001.

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Iterable
Repeatable File Store Iterable
non-repeatable-iterable

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-220)Output

Type

Array of * Any

### [](#for-configurations-220)For Configurations - [Configurations](#Config) ### [](#throws-220)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Issuetypescreenscheme)Get Issue Type Screen Schemes `` Returns a paginated list of issue type screen schemes. Only issue type screen schemes used in classic projects are returned. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/issuetypescreenscheme endpoint. ### [](#parameters-222)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Array of Number

The list of issue type screen scheme IDs. To include multiple IDs, provide an ampersand-separated list. For example, id=10000&id=10001.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-221)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-221)For Configurations - [Configurations](#Config) ### [](#throws-221)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssuetypescreenschemeMapping)Get Issue Type Screen Scheme Mappings `` Returns a paginated list of issue type screen scheme items. Only issue type screen schemes used in classic projects are returned. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/issuetypescreenscheme/mapping endpoint. ### [](#parameters-223)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Issue Type Screen Scheme Id

Array of Number

The list of issue type screen scheme IDs. To include multiple issue type screen schemes, separate IDs with ampersand: issueTypeScreenSchemeId=10000&issueTypeScreenSchemeId=10001.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-222)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-222)For Configurations - [Configurations](#Config) ### [](#throws-222)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3IssuetypescreenschemeProject)Get Issue Type Screen Scheme Project Associations `` Returns a paginated list of issue type screen schemes and, for each issue type screen scheme, a list of the projects that use it. Only issue type screen schemes used in classic projects are returned. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/issuetypescreenscheme/project endpoint. ### [](#parameters-224)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Project Id

Array of Number

The list of project IDs. To include multiple projects, separate IDs with ampersand: projectId=10000&projectId=10001.

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Iterable
Repeatable File Store Iterable
non-repeatable-iterable

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-223)Output

Type

Array of * Any

### [](#for-configurations-223)For Configurations - [Configurations](#Config) ### [](#throws-223)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3JqlAutocompletedata)Get Auto Complete `` Returns reference data for JQL searches. This is a downloadable version of the documentation provided in \[Advanced searching - fields reference\](https://docs.mulesoft.com/jira-connector/latest/[https://support.atlassian.com/jira-software-cloud/docs/jql-fields/](https://support.atlassian.com/jira-software-cloud/docs/jql-fields/)) and [Advanced searching - functions reference](https://support.atlassian.com/jira-software-cloud/docs/jql-functions/), along with a list of JQL-reserved words. Use this information to assist with the programmatic creation of JQL queries or the validation of queries built in a custom query builder. This operation can be accessed anonymously. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/jql/autocompletedata endpoint. ### [](#parameters-225)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-224)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-224)For Configurations - [Configurations](#Config) ### [](#throws-224)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3JqlAutocompletedataSuggestions)Get Field Auto Complete For Query String `` Returns the JQL search auto complete suggestions for a field. Suggestions can be obtained by providing: - `fieldName` to get a list of all values for the field. - `fieldName` and `fieldValue` to get a list of values containing the text in `fieldValue`. - `fieldName` and `predicateName` to get a list of all predicate values for the field. - `fieldName`, `predicateName`, and `predicateValue` to get a list of predicate values containing the text in `predicateValue`. This operation can be accessed anonymously. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/jql/autocompletedata/suggestions endpoint. ### [](#parameters-226)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Name

String

The name of the field.

Field Value

String

The partial field item name entered by the user.

Predicate Name

String

The name of the CHANGED operator predicate for which the suggestions are generated. The valid predicate operators are by, from, and to.

Predicate Value

String

The partial predicate item name entered by the user.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-225)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-225)For Configurations - [Configurations](#Config) ### [](#throws-225)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Label)Get All Labels `` Returns a paginated list of labels. This operation makes an HTTP GET request to the /rest/api/3/label endpoint. ### [](#parameters-227)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

1000

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-226)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-226)For Configurations - [Configurations](#Config) ### [](#throws-226)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Mypermissions)Get My Permissions `` Returns a list of permissions indicating which permissions the user has. Details of the user’s permissions can be obtained in a global, project, or issue context. The user is reported as having a project permission: - in the global context, if the user has the project permission in any project. - for a project, where the project permission is determined using issue data, if the user meets the permission’s criteria for any issue in the project. Otherwise, if the user has the project permission in the project. - for an issue, where a project permission is determined using issue data, if the user has the permission in the issue. Otherwise, if the user has the project permission in the project containing the issue. This means that users may be shown as having an issue permission (such as EDIT\\\_ISSUES) in the global context or a project context but may not have the permission for any or all issues. For example, if Reporters have the EDIT\\\_ISSUES permission a user would be shown as having this permission in the global context or the context of a project, because any user can be a reporter. However, if they are not the user who reported the issue queried they would not have EDIT\\\_ISSUES permission for that issue. Global permissions are unaffected by context. This operation can be accessed anonymously. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/mypermissions endpoint. ### [](#parameters-228)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Key

String

The key of project. Ignored if projectId is provided.

Project Id

String

The ID of project.

Issue Key

String

The key of the issue. Ignored if issueId is provided.

Issue Id

String

The ID of the issue.

permissions

String

A list of permission keys. (Required) This parameter accepts a comma-separated list. To get the list of available permissions, use [Get all permissions](#api-rest-api-3-permissions-get).

Project Uuid

String

Project Uuid

Project Configuration Uuid

String

Project Configuration Uuid

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-227)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-227)For Configurations - [Configurations](#Config) ### [](#throws-227)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Mypreferences)Get Preference `` Returns the value of a preference of the current user. Note that these keys are deprecated: - **jira.user.locale** The locale of the user. By default this is not set and the user takes the locale of the instance. - **jira.user.timezone** The time zone of the user. By default this is not set and the user takes the timezone of the instance. Use [Update a user profile](https://developer.atlassian.com/cloud/admin/user-management/rest/#api-users-account-id-manage-profile-patch) from the user management REST API to manage timezone and locale instead. **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/mypreferences endpoint. ### [](#parameters-229)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

key

String

The key of the preference.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-228)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-228)For Configurations - [Configurations](#Config) ### [](#throws-228)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3MypreferencesLocale)Get Locale `` Returns the locale for the user. If the user has no language preference set (which is the default setting) or this resource is accessed anonymous, the browser locale detected by Jira is returned. Jira detects the browser locale using the **Accept-Language** header in the request. However, if this doesn’t match a locale available Jira, the site default locale is returned. This operation can be accessed anonymously. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/mypreferences/locale endpoint. ### [](#parameters-230)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-229)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-229)For Configurations - [Configurations](#Config) ### [](#throws-229)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Myself)Get Current User `` Returns details for the current user. **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/myself endpoint. ### [](#parameters-231)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

expand

String

Use expand to include additional information about user in the response. This parameter accepts a comma-separated list. Expand options include:

groups Returns all groups, including nested groups, the user belongs to.
applicationRoles Returns the application roles the user is assigned to.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-230)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-230)For Configurations - [Configurations](#Config) ### [](#throws-230)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Notificationscheme)Get Notification Schemes `` Returns a paginated list of [notification schemes](https://confluence.atlassian.com/x/8YdKLg) ordered by display name. ### [](#about-notification-schemes)About notification schemes A notification scheme is a list of events and recipients who will receive notifications for those events. The list is contained within the `notificationSchemeEvents` object and contains pairs of `events` and `notifications`: - `event` Identifies the type of event. The events can be [Jira system events](https://confluence.atlassian.com/x/8YdKLg#Creatinganotificationscheme-eventsEvents) or [custom events](https://confluence.atlassian.com/x/AIlKLg). - `notifications` Identifies the [recipients](https://confluence.atlassian.com/x/8YdKLg#Creatinganotificationscheme-recipientsRecipients) of notifications for each event. Recipients can be any of the following types: - `CurrentAssignee` - `Reporter` - `CurrentUser` - `ProjectLead` - `ComponentLead` - `User` (the `parameter` is the user key) - `Group` (the `parameter` is the group name) - `ProjectRole` (the `parameter` is the project role ID) - `EmailAddress` - `AllWatchers` - `UserCustomField` (the `parameter` is the ID of the custom field) - `GroupCustomField`(the `parameter` is the ID of the custom field) **Note that you should allow for events without recipients to appear in responses.** **Permissions required:** Permission to access Jira, however the user must have permission to administer at least one project associated with a notification scheme for it to be returned. This operation makes an HTTP GET request to the /rest/api/3/notificationscheme endpoint. ### [](#parameters-232)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

expand

String

Use expand to include additional information in the response. This parameter accepts a comma-separated list. Expand options include:

all Returns all expandable information.
field Returns information about any custom fields assigned to receive an event.
group Returns information about any groups assigned to receive an event.
notificationSchemeEvents Returns a list of event associations. This list is returned for all expandable information.
projectRole Returns information about any project roles assigned to receive an event.
user Returns information about any users assigned to receive an event.

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Iterable
Repeatable File Store Iterable
non-repeatable-iterable

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-231)Output

Type

Array of * Any

### [](#for-configurations-231)For Configurations - [Configurations](#Config) ### [](#throws-231)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3NotificationschemeById)Get Notification Scheme `` Returns a [notification scheme](https://confluence.atlassian.com/x/8YdKLg), including the list of events and the recipients who will receive notifications for those events. **Permissions required:** Permission to access Jira, however the user must have permission to administer at least one project associated with the notification scheme. This operation makes an HTTP GET request to the /rest/api/3/notificationscheme/{id} endpoint. ### [](#parameters-233)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the notification scheme. Use [Get notification schemes paginated](#api-rest-api-3-notificationscheme-get) to get a list of notification scheme IDs.

expand

String

Use expand to include additional information in the response. This parameter accepts a comma-separated list. Expand options include:

all Returns all expandable information.
field Returns information about any custom fields assigned to receive an event.
group Returns information about any groups assigned to receive an event.
notificationSchemeEvents Returns a list of event associations. This list is returned for all expandable information.
projectRole Returns information about any project roles assigned to receive an event.
user Returns information about any users assigned to receive an event.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-232)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-232)For Configurations - [Configurations](#Config) ### [](#throws-232)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Permissions)Get All Permissions `` Returns all permissions, including: \* global permissions. \* project permissions. \* global permissions added by plugins. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/permissions endpoint. ### [](#parameters-234)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-233)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-233)For Configurations - [Configurations](#Config) ### [](#throws-233)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Permissionscheme)Get All Permission Schemes `` Returns all permission schemes. ### [](#about-permission-schemes-and-grants)About permission schemes and grants A permission scheme is a collection of permission grants. A permission grant consists of a `holder` and a `permission`. #### [](#holder-object)Holder object The `holder` object contains information about the user or group being granted the permission. For example, the **Administer projects** permission is granted to a group named **Teams in space administrators**. In this case, the type is `"type": "group"`, and the parameter is the group name, `"parameter": "Teams in space administrators"`. The `holder` object is defined by the following properties: - `type` Identifies the user or group (see the list of types below). - `parameter` The value of this property depends on the `type`. For example, if the `type` is a group, then you need to specify the group name. The following `types` are available. The expected values for the `parameter` are given in parenthesis (some `types` may not have a `parameter`): - `anyone` Grant for anonymous users. - `applicationRole` Grant for users with access to the specified application (application name). See \[Update product access settings\](https://docs.mulesoft.com/jira-connector/latest/[https://support.atlassian.com/user-management/docs/give-users-access-to-products/](https://support.atlassian.com/user-management/docs/give-users-access-to-products/)) for more information. - `assignee` Grant for the user currently assigned to an issue. - `group` Grant for the specified group (group name). - `groupCustomField` Grant for a user in the group selected in the specified custom field (custom field ID). - `projectLead` Grant for a project lead. - `projectRole` Grant for the specified project role (project role ID). - `reporter` Grant for the user who reported the issue. \* `sd.customer.portal.only` Jira Service Desk only. Grants customers permission to access the customer portal but not Jira. See \[Customizing Jira Service Desk permissions\](https://docs.mulesoft.com/jira-connector/latest/[https://confluence.atlassian.com/x/24dKLg](https://confluence.atlassian.com/x/24dKLg)) for more information. - `user` Grant for the specified user (user ID - historically this was the userkey but that is deprecated and the account ID should be used). - `userCustomField` Grant for a user selected in the specified custom field (custom field ID). #### [](#built-in-permissions)Built-in permissions The \[built-in Jira permissions\](https://docs.mulesoft.com/jira-connector/latest/[https://confluence.atlassian.com/x/yodKLg](https://confluence.atlassian.com/x/yodKLg)) are listed below. Apps can also define custom permissions. See the [project permission](https://developer.atlassian.com/cloud/jira/platform/modules/project-permission/) and [global permission](https://developer.atlassian.com/cloud/jira/platform/modules/global-permission/) module documentation for more information. **Project permissions** - `ADMINISTER_PROJECTS` - `BROWSE_PROJECTS` - `MANAGE_SPRINTS_PERMISSION` (Jira Software only) - `SERVICEDESK_AGENT` (Jira Service Desk only) - `VIEW_DEV_TOOLS` (Jira Software only) - `VIEW_READONLY_WORKFLOW` **Issue permissions** - `ASSIGNABLE_USER` - `ASSIGN_ISSUES` - `CLOSE_ISSUES` - `CREATE_ISSUES` - `DELETE_ISSUES` - `EDIT_ISSUES` - `LINK_ISSUES` - `MODIFY_REPORTER` - `MOVE_ISSUES` - `RESOLVE_ISSUES` - `SCHEDULE_ISSUES` - `SET_ISSUE_SECURITY` - `TRANSITION_ISSUES` **Voters and watchers permissions** - `MANAGE_WATCHERS` - `VIEW_VOTERS_AND_WATCHERS` **Comments permissions** - `ADD_COMMENTS` - `DELETE_ALL_COMMENTS` - `DELETE_OWN_COMMENTS` - `EDIT_ALL_COMMENTS` - `EDIT_OWN_COMMENTS` **Attachments permissions** - `CREATE_ATTACHMENTS` - `DELETE_ALL_ATTACHMENTS` - `DELETE_OWN_ATTACHMENTS` **Time tracking permissions** - `DELETE_ALL_WORKLOGS` - `DELETE_OWN_WORKLOGS` - `EDIT_ALL_WORKLOGS` - `EDIT_OWN_WORKLOGS` - `WORK_ON_ISSUES` **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/permissionscheme endpoint. ### [](#parameters-235)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

expand

String

Use expand to include additional information in the response. This parameter accepts a comma-separated list. Note that permissions are included when you specify any value. Expand options include:

all Returns all expandable information.
field Returns information about the custom field granted the permission.
group Returns information about the group that is granted the permission.
permissions Returns all permission grants for each permission scheme.
projectRole Returns information about the project role granted the permission.
user Returns information about the user who is granted the permission.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-234)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-234)For Configurations - [Configurations](#Config) ### [](#throws-234)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3PermissionschemeBySchemeId)Get Permission Scheme `` Returns a permission scheme. **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/permissionscheme/{schemeId} endpoint. ### [](#parameters-236)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Scheme Id

Number

The ID of the permission scheme to return.

expand

String

Use expand to include additional information in the response. This parameter accepts a comma-separated list. Note that permissions are included when you specify any value. Expand options include:

all Returns all expandable information.
field Returns information about the custom field granted the permission.
group Returns information about the group that is granted the permission.
permissions Returns all permission grants for each permission scheme.
projectRole Returns information about the project role granted the permission.
user Returns information about the user who is granted the permission.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-235)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-235)For Configurations - [Configurations](#Config) ### [](#throws-235)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3PermissionschemePermissionBySchemeId)Get Permission Scheme Grants `` Returns all permission grants for a permission scheme. **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/permissionscheme/{schemeId}/permission endpoint. ### [](#parameters-237)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Scheme Id

Number

The ID of the permission scheme.

expand

String

permissions Returns all permission grants for each permission scheme.
user Returns information about the user who is granted the permission.
group Returns information about the group that is granted the permission.
projectRole Returns information about the project role granted the permission.
field Returns information about the custom field granted the permission.
all Returns all expandable information.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-236)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-236)For Configurations - [Configurations](#Config) ### [](#throws-236)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3PermissionschemePermissionBySchemeIdPermissionId)Get Permission Scheme Grant `` Returns a permission grant. **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/permissionscheme/{schemeId}/permission/{permissionId} endpoint. ### [](#parameters-238)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Scheme Id

Number

The ID of the permission scheme.

Permission Id

Number

The ID of the permission grant.

expand

String

all Returns all expandable information.
field Returns information about the custom field granted the permission.
group Returns information about the group that is granted the permission.
permissions Returns all permission grants for each permission scheme.
projectRole Returns information about the project role granted the permission.
user Returns information about the user who is granted the permission.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-237)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-237)For Configurations - [Configurations](#Config) ### [](#throws-237)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Priority)Get Priorities `` Returns the list of all issue priorities. **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/priority endpoint. ### [](#parameters-239)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-238)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-238)For Configurations - [Configurations](#Config) ### [](#throws-238)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3PriorityById)Get Priority `` Returns an issue priority. **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/priority/{id} endpoint. ### [](#parameters-240)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the issue priority.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-239)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-239)For Configurations - [Configurations](#Config) ### [](#throws-239)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectAvatarsByProjectIdOrKey)Get All Project Avatars `` Returns all project avatars, grouped by system and custom avatars. This operation can be accessed anonymously. **Permissions required:** **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project. This operation makes an HTTP GET request to the /rest/api/3/project/{projectIdOrKey}/avatars endpoint. ### [](#parameters-241)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The ID or (case-sensitive) key of the project.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-240)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-240)For Configurations - [Configurations](#Config) ### [](#throws-240)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectByProjectIdOrKey)Get Project `` Returns the \[project details\](https://docs.mulesoft.com/jira-connector/latest/[https://support.atlassian.com/jira-software-cloud/docs/edit-a-projects-details/](https://support.atlassian.com/jira-software-cloud/docs/edit-a-projects-details/)) for a project. This operation can be accessed anonymously. **Permissions required:** **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project. This operation makes an HTTP GET request to the /rest/api/3/project/{projectIdOrKey} endpoint. ### [](#parameters-242)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or project key (case sensitive).

expand

String

Use expand to include additional information in the response. This parameter accepts a comma-separated list. Note that the project description, issue types, and project lead are included in all responses by default. Expand options include:

description The project description.
issueTypes The issue types associated with the project.
lead The project lead. * projectKeys All project keys associated with the project.
issueTypeHierarchy The project issue type hierarchy.

properties

Array of String

A list of project properties to return for the project. This parameter accepts a comma-separated list.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-241)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-241)For Configurations - [Configurations](#Config) ### [](#throws-241)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectCategory)Get All Project Categories `` Returns all project categories. **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/projectCategory endpoint. ### [](#parameters-243)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-242)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-242)For Configurations - [Configurations](#Config) ### [](#throws-242)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectCategoryById)Get Project Category By Id `` Returns a project category. **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/projectCategory/{id} endpoint. ### [](#parameters-244)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the project category.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-243)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-243)For Configurations - [Configurations](#Config) ### [](#throws-243)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectComponentByProjectIdOrKey)Get Project Components Paginated `` Returns a paginated list of all components in a project. See the \[Get project components\](#api-rest-api-3-project-projectIdOrKey-components-get) resource if you want to get a full list of versions without pagination. This operation can be accessed anonymously. **Permissions required:** **Browse Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project. This operation makes an HTTP GET request to the /rest/api/3/project/{projectIdOrKey}/component endpoint. ### [](#parameters-245)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or project key (case sensitive).

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Order By

Enumeration, one of:

DESCRIPTION
ISSUE_COUNT
LEAD
NAME

Order the results by a field:

description Sorts by the component description.
issueCount Sorts by the count of issues associated with the component.
lead Sorts by the user key of the component’s project lead.
name Sorts by component name.

query

String

Filter the results using a literal string. Components with a matching name or description are returned (case insensitive).

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-244)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-244)For Configurations - [Configurations](#Config) ### [](#throws-244)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectComponentsByProjectIdOrKey)Get Project Components `` Returns all components in a project. See the \[Get project components paginated\](#api-rest-api-3-project-projectIdOrKey-component-get) resource if you want to get a full list of components with pagination. This operation can be accessed anonymously. **Permissions required:** **Browse Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project. This operation makes an HTTP GET request to the /rest/api/3/project/{projectIdOrKey}/components endpoint. ### [](#parameters-246)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or project key (case sensitive).

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-245)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-245)For Configurations - [Configurations](#Config) ### [](#throws-245)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectEmailByProjectId)Get Project Email `` Returns the \[project’s sender email address\](https://docs.mulesoft.com/jira-connector/latest/[https://confluence.atlassian.com/x/dolKLg](https://confluence.atlassian.com/x/dolKLg)). **Permissions required:** **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project. This operation makes an HTTP GET request to the /rest/api/3/project/{projectId}/email endpoint. ### [](#parameters-247)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id

Number

The project ID.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-246)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-246)For Configurations - [Configurations](#Config) ### [](#throws-246)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectHierarchyByProjectId)Get Hierarchy `` Get the issue type hierarchy for a next-gen project. The issue type hierarchy for a project consists of: - **Epic** at level 1 (optional). - One or more issue types at level 0 such as **Story**, **Task**, or **Bug**. Where the issue type **Epic** is defined, these issue types are used to break down the content of an epic. - **Subtask** at level -1 (optional). This issue type enables level 0 issue types to be broken down into components. Issues based on a level -1 issue type must have a parent issue. **Permissions required:** **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project. This operation makes an HTTP GET request to the /rest/api/3/project/{projectId}/hierarchy endpoint. ### [](#parameters-248)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id

Number

The ID of the project.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-247)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-247)For Configurations - [Configurations](#Config) ### [](#throws-247)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectIssuesecuritylevelschemeByProjectKeyOrId)Get Project Issue Security Scheme `` Returns the [issue security scheme](https://confluence.atlassian.com/x/J4lKLg) associated with the project. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) or the **Administer Projects** [project permission](https://confluence.atlassian.com/x/yodKLg). This operation makes an HTTP GET request to the /rest/api/3/project/{projectKeyOrId}/issuesecuritylevelscheme endpoint. ### [](#parameters-249)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Key Or Id

String

The project ID or project key (case sensitive).

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-248)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-248)For Configurations - [Configurations](#Config) ### [](#throws-248)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectNotificationschemeByProjectKeyOrId)Get Notification Scheme For Project `` Gets a [notification scheme](https://confluence.atlassian.com/x/8YdKLg) associated with the project. See the \[Get notification scheme\](#api-rest-api-3-notificationscheme-id-get) resource for more information about notification schemes. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) or **Administer Projects** [project permission](https://confluence.atlassian.com/x/yodKLg). This operation makes an HTTP GET request to the /rest/api/3/project/{projectKeyOrId}/notificationscheme endpoint. ### [](#parameters-250)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Key Or Id

String

The project ID or project key (case sensitive).

expand

String

Use expand to include additional information in the response. This parameter accepts a comma-separated list. Expand options include:

all Returns all expandable information.
field Returns information about any custom fields assigned to receive an event.
group Returns information about any groups assigned to receive an event.
notificationSchemeEvents Returns a list of event associations. This list is returned for all expandable information.
projectRole Returns information about any project roles assigned to receive an event.
user Returns information about any users assigned to receive an event.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-249)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-249)For Configurations - [Configurations](#Config) ### [](#throws-249)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectPermissionschemeByProjectKeyOrId)Get Assigned Permission Scheme `` Gets the [permission scheme](https://confluence.atlassian.com/x/yodKLg) associated with the project. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) or **Administer projects** [project permission](https://confluence.atlassian.com/x/yodKLg). This operation makes an HTTP GET request to the /rest/api/3/project/{projectKeyOrId}/permissionscheme endpoint. ### [](#parameters-251)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Key Or Id

String

The project ID or project key (case sensitive).

expand

String

Use expand to include additional information in the response. This parameter accepts a comma-separated list. Note that permissions are included when you specify any value. Expand options include:

all Returns all expandable information.
field Returns information about the custom field granted the permission.
group Returns information about the group that is granted the permission.
permissions Returns all permission grants for each permission scheme.
projectRole Returns information about the project role granted the permission.
user Returns information about the user who is granted the permission.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-250)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-250)For Configurations - [Configurations](#Config) ### [](#throws-250)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectPropertiesByProjectIdOrKey)Get Project Property Keys `` Returns all [project property](https://developer.atlassian.com/cloud/jira/platform/storing-data-with-entity-properties/) keys for the project. This operation can be accessed anonymously. **Permissions required:** **Browse Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project. This operation makes an HTTP GET request to the /rest/api/3/project/{projectIdOrKey}/properties endpoint. ### [](#parameters-252)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or project key (case sensitive).

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-251)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-251)For Configurations - [Configurations](#Config) ### [](#throws-251)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectPropertiesByProjectIdOrKeyPropertyKey)Get Project Property `` Returns the value of a \[project property\](https://docs.mulesoft.com/jira-connector/latest/[https://developer.atlassian.com/cloud/jira/platform/storing-data-with-entity-properties/](https://developer.atlassian.com/cloud/jira/platform/storing-data-with-entity-properties/)). This operation can be accessed anonymously. **Permissions required:** **Browse Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project containing the property. This operation makes an HTTP GET request to the /rest/api/3/project/{projectIdOrKey}/properties/{propertyKey} endpoint. ### [](#parameters-253)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or project key (case sensitive).

Property Key

String

The project property key. Use [Get project property keys](#api-rest-api-3-project-projectIdOrKey-properties-get) to get a list of all project property keys.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-252)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-252)For Configurations - [Configurations](#Config) ### [](#throws-252)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectRoleByProjectIdOrKey)Get Project Roles `` Returns a list of [project roles](https://confluence.atlassian.com/x/3odKLg) for the project returning the name and self URL for each role. Note that all project roles are shared with all projects in Jira Cloud. See \[Get all project roles\](#api-rest-api-3-role-get) for more information. This operation can be accessed anonymously. **Permissions required:** **Administer Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for any project on the site or **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP GET request to the /rest/api/3/project/{projectIdOrKey}/role endpoint. ### [](#parameters-254)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or project key (case sensitive).

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-253)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-253)For Configurations - [Configurations](#Config) ### [](#throws-253)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectRoleByProjectIdOrKeyId)Get Project Role `` Returns a project role’s details and actors associated with the project. The list of actors is sorted by display name. To check whether a user belongs to a role based on their group memberships, use \[Get user\](#api-rest-api-3-user-get) with the `groups` expand parameter selected. Then check whether the user keys and groups match with the actors returned for the project. This operation can be accessed anonymously. **Permissions required:** **Administer Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project or **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP GET request to the /rest/api/3/project/{projectIdOrKey}/role/{id} endpoint. ### [](#parameters-255)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or project key (case sensitive).

Number

The ID of the project role. Use [Get all project roles](#api-rest-api-3-role-get) to get a list of project role IDs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-254)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-254)For Configurations - [Configurations](#Config) ### [](#throws-254)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectRoledetailsByProjectIdOrKey)Get Project Role Details `` Returns all [project roles](https://confluence.atlassian.com/x/3odKLg) and the details for each role. Note that the list of project roles is common to all projects. This operation can be accessed anonymously. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) or **Administer projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project. This operation makes an HTTP GET request to the /rest/api/3/project/{projectIdOrKey}/roledetails endpoint. ### [](#parameters-256)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or project key (case sensitive).

Current Member

Boolean

Whether the roles should be filtered to include only those the user is assigned to.

false

Exclude Connect Addons

Boolean

Exclude Connect Addons

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-255)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-255)For Configurations - [Configurations](#Config) ### [](#throws-255)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectSearch)Search Projects `` Returns a paginated list of projects visible to the user. This operation can be accessed anonymously. **Permissions required:** Projects are returned only where the user has one of: - **Browse Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project. - **Administer Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project. - **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP GET request to the /rest/api/3/project/search endpoint. ### [](#parameters-257)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Order By

Enumeration, one of:

CATEGORY
KEY
NAME
OWNER
ISSUE_COUNT
LAST_ISSUE_UPDATED_DATE
ARCHIVED_DATE
DELETED_DATE

Order the results by a field.

category Sorts by project category. A complete list of category IDs is found using [Get all project categories](#api-rest-api-3-projectCategory-get).
issueCount Sorts by the total number of issues in each project.
key Sorts by project key.
lastIssueUpdatedTime Sorts by the last issue update time.
name Sorts by project name.
owner Sorts by project lead.
archivedDate EXPERIMENTAL. Sorts by project archived date.
deletedDate EXPERIMENTAL. Sorts by project deleted date.

KEY

query

String

Filter the results using a literal string. Projects with a matching key or name are returned (case insensitive).

Type Key

String

Orders results by the [project type](https://docs.mulesoft.com/jira-connector/latest/%3Ca href="https://support.atlassian.com/jira-software-cloud/docs/what-is-the-jira-family-of-products/" class="bare">https://support.atlassian.com/jira-software-cloud/docs/what-is-the-jira-family-of-products/). This parameter accepts a comma-separated list. Valid values are business, service_desk, and software.

Category Id

Number

The ID of the project’s category. A complete list of category IDs is found using the [Get all project categories](#api-rest-api-3-projectCategory-get) operation.

action

Enumeration, one of:

VIEW
BROWSE
EDIT

Filter results by projects for which the user can:

view the project, meaning that they have one of the following permissions:
Browse projects project permission for the project.
Administer projects project permission for the project.
Administer Jira global permission.
browse the project, meaning that they have the Browse projects project permission for the project.
edit the project, meaning that they have one of the following permissions:
- Administer projects project permission for the project.
- Administer Jira global permission.

VIEW

expand

String

Use expand to include additional information in the response. This parameter accepts a comma-separated list. Expanded options include:

description Returns the project description.
projectKeys Returns all project keys associated with a project.
lead Returns information about the project lead.
issueTypes Returns all issue types associated with the project.
url Returns the URL associated with the project.
insight EXPERIMENTAL. Returns the insight details of total issue count and last issue update time for the project.

status

Array of Enumeration, one of:

LIVE
ARCHIVED
DELETED

EXPERIMENTAL. Filter results by project status:

live Search live projects.
archived Search archived projects.
deleted Search deleted projects, those in the recycle bin.

properties

Array of String

EXPERIMENTAL. A list of project properties to return for the project. This parameter accepts a comma-separated list.

Property Query

String

EXPERIMENTAL. A query string used to search properties. The query string cannot be specified using a JSON object. For example, to search for the value of nested from {"something":{"nested":1,"other":2}} use [thepropertykey].something.nested=1. Note that the propertyQuery key is enclosed in square brackets to enable searching where the propertyQuery key includes dot (.) or equals (=) characters.

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Iterable
Repeatable File Store Iterable
non-repeatable-iterable

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-256)Output

Type

Array of * Any

### [](#for-configurations-256)For Configurations - [Configurations](#Config) ### [](#throws-256)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectSecuritylevelByProjectKeyOrId)Get Security Levels For Project `` Returns all [issue security](https://confluence.atlassian.com/x/J4lKLg) levels for the project that the user has access to. This operation can be accessed anonymously. **Permissions required:** **Browse projects** [global permission](https://confluence.atlassian.com/x/x4dKLg) for the project, however, issue security levels are only returned for authenticated user with **Set Issue Security** [global permission](https://confluence.atlassian.com/x/x4dKLg) for the project. This operation makes an HTTP GET request to the /rest/api/3/project/{projectKeyOrId}/securitylevel endpoint. ### [](#parameters-258)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Key Or Id

String

The project ID or project key (case sensitive).

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-257)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-257)For Configurations - [Configurations](#Config) ### [](#throws-257)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectStatusesByProjectIdOrKey)Get All Statuses `` Returns the valid statuses for a project. The statuses are grouped by issue type, as each project has a set of valid issue types and each issue type has a set of valid statuses. This operation can be accessed anonymously. **Permissions required:** **Browse Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project. This operation makes an HTTP GET request to the /rest/api/3/project/{projectIdOrKey}/statuses endpoint. ### [](#parameters-259)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or project key (case sensitive).

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-258)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-258)For Configurations - [Configurations](#Config) ### [](#throws-258)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectType)Get All Project Types `` Returns all [project types](https://confluence.atlassian.com/adminjiraserver/jira-applications-and-project-types-overview-938846805.html), whether or not the instance has a valid license for each type. This operation can be accessed anonymously. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/project/type endpoint. ### [](#parameters-260)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-259)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-259)For Configurations - [Configurations](#Config) ### [](#throws-259)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectTypeAccessible)Get All Accessible Project Types `` Returns all [project types](https://confluence.atlassian.com/adminjiraserver/jira-applications-and-project-types-overview-938846805.html) with a valid license. This operation makes an HTTP GET request to the /rest/api/3/project/type/accessible endpoint. ### [](#parameters-261)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-260)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-260)For Configurations - [Configurations](#Config) ### [](#throws-260)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectTypeAccessibleByProjectTypeKey)Get Accessible Project Type By Key `` Returns a [project type](https://confluence.atlassian.com/adminjiraserver/jira-applications-and-project-types-overview-938846805.html) if it is accessible to the user. **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/project/type/{projectTypeKey}/accessible endpoint. ### [](#parameters-262)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Type Key

Enumeration, one of:

SOFTWARE
SERVICE_DESK
BUSINESS

The key of the project type.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-261)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-261)For Configurations - [Configurations](#Config) ### [](#throws-261)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectTypeByProjectTypeKey)Get Project Type By Key `` Returns a \[project type\](https://docs.mulesoft.com/jira-connector/latest/[https://confluence.atlassian.com/adminjiraserver/jira-applications-and-project-types-overview-938846805.html](https://confluence.atlassian.com/adminjiraserver/jira-applications-and-project-types-overview-938846805.html)). This operation can be accessed anonymously. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/project/type/{projectTypeKey} endpoint. ### [](#parameters-263)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Type Key

Enumeration, one of:

SOFTWARE
SERVICE_DESK
BUSINESS

The key of the project type.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-262)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-262)For Configurations - [Configurations](#Config) ### [](#throws-262)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectVersionByProjectIdOrKey)Get Project Versions Paginated `` Returns a paginated list of all versions in a project. See the \[Get project versions\](#api-rest-api-3-project-projectIdOrKey-versions-get) resource if you want to get a full list of versions without pagination. This operation can be accessed anonymously. **Permissions required:** **Browse Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project. This operation makes an HTTP GET request to the /rest/api/3/project/{projectIdOrKey}/version endpoint. ### [](#parameters-264)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or project key (case sensitive).

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Order By

Enumeration, one of:

DESCRIPTION
NAME
RELEASE_DATE
SEQUENCE
START_DATE

Order the results by a field:

description Sorts by version description.
name Sorts by version name.
releaseDate Sorts by release date, starting with the oldest date. Versions with no release date are listed last.
sequence Sorts by the order of appearance in the user interface.
startDate Sorts by start date, starting with the oldest date. Versions with no start date are listed last.

query

String

Filter the results using a literal string. Versions with matching name or description are returned (case insensitive).

status

String

A list of status values used to filter the results by version status. This parameter accepts a comma-separated list. The status values are released, unreleased, and archived.

expand

String

Use expand to include additional information in the response. This parameter accepts a comma-separated list. Expand options include:

issuesstatus Returns the number of issues in each status category for each version.
operations Returns actions that can be performed on the specified version.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-263)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-263)For Configurations - [Configurations](#Config) ### [](#throws-263)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectVersionsByProjectIdOrKey)Get Project Versions `` Returns all versions in a project. The response is not paginated. Use \[Get project versions paginated\](#api-rest-api-3-project-projectIdOrKey-version-get) if you want to get the versions in a project with pagination. This operation can be accessed anonymously. **Permissions required:** **Browse Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project. This operation makes an HTTP GET request to the /rest/api/3/project/{projectIdOrKey}/versions endpoint. ### [](#parameters-265)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or project key (case sensitive).

expand

String

Use expand to include additional information in the response. This parameter accepts operations, which returns actions that can be performed on the version.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-264)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-264)For Configurations - [Configurations](#Config) ### [](#throws-264)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectvalidateKey)Validate Project Key `` Validates a project key by confirming the key is a valid string and not in use. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/projectvalidate/key endpoint. ### [](#parameters-266)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

key

String

The project key.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-265)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-265)For Configurations - [Configurations](#Config) ### [](#throws-265)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectvalidateValidProjectKey)Get Valid Project Key `` Validates a project key and, if the key is invalid or in use, generates a valid random string for the project key. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/projectvalidate/validProjectKey endpoint. ### [](#parameters-267)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

key

String

The project key.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-266)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-266)For Configurations - [Configurations](#Config) ### [](#throws-266)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ProjectvalidateValidProjectName)Get Valid Project Name `` Checks that a project name isn’t in use. If the name isn’t in use, the passed string is returned. If the name is in use, this operation attempts to generate a valid project name based on the one supplied, usually by adding a sequence number. If a valid project name cannot be generated, a 404 response is returned. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/projectvalidate/validProjectName endpoint. ### [](#parameters-268)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

name

String

The project name.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-267)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-267)For Configurations - [Configurations](#Config) ### [](#throws-267)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Resolution)Get Resolutions `` Returns a list of all issue resolution values. **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/resolution endpoint. ### [](#parameters-269)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-268)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-268)For Configurations - [Configurations](#Config) ### [](#throws-268)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ResolutionById)Get Resolution `` Returns an issue resolution value. **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/resolution/{id} endpoint. ### [](#parameters-270)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the issue resolution value.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-269)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-269)For Configurations - [Configurations](#Config) ### [](#throws-269)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Role)Get All Project Roles `` Gets a list of all project roles, complete with project role details and default actors. ### [](#about-project-roles)About project roles [Project roles](https://confluence.atlassian.com/x/3odKLg) are a flexible way to associate users and groups with projects. In Jira Cloud, the list of project roles is shared globally with all projects, but each project can have a different set of actors associated with it (unlike groups, which have the same membership throughout all Jira applications). Project roles are used in \[permission schemes\](#api-rest-api-3-permissionscheme-get), \[email notification schemes\](#api-rest-api-3-notificationscheme-get), \[issue security levels\](#api-rest-api-3-issuesecurityschemes-get), \[comment visibility\](#api-rest-api-3-comment-list-post), and workflow conditions. ### [](#members-and-actors)Members and actors In the Jira REST API, a member of a project role is called an **actor**. An **actor** is a group or user associated with a project role. Actors may be set as [default members](https://confluence.atlassian.com/x/3odKLg#Managingprojectroles-Specifying’defaultmembers’foraprojectrole) of the project role or set at the project level: - Default actors: Users and groups that are assigned to the project role for all newly created projects. The default actors can be removed at the project level later if desired. - Actors: Users and groups that are associated with a project role for a project, which may differ from the default actors. This enables you to assign a user to different roles in different projects. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/role endpoint. ### [](#parameters-271)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-270)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-270)For Configurations - [Configurations](#Config) ### [](#throws-270)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3RoleActorsById)Get Project Role Actors For Role `` Returns the \[default actors\](#api-rest-api-3-resolution-get) for the project role. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/role/{id}/actors endpoint. ### [](#parameters-272)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the project role. Use [Get all project roles](#api-rest-api-3-role-get) to get a list of project role IDs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-271)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-271)For Configurations - [Configurations](#Config) ### [](#throws-271)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3RoleById)Get Project Role By Id `` Gets the project role details and the default actors associated with the role. The list of default actors is sorted by display name. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/role/{id} endpoint. ### [](#parameters-273)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the project role. Use [Get all project roles](#api-rest-api-3-role-get) to get a list of project role IDs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-272)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-272)For Configurations - [Configurations](#Config) ### [](#throws-272)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Screens)Get Screens `` Returns a paginated list of all screens or those specified by one or more screen IDs. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/screens endpoint. ### [](#parameters-274)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

100

Array of Number

The list of screen IDs. To include multiple IDs, provide an ampersand-separated list. For example, id=10000&id=10001.

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Iterable
Repeatable File Store Iterable
non-repeatable-iterable

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-273)Output

Type

Array of * Any

### [](#for-configurations-273)For Configurations - [Configurations](#Config) ### [](#throws-273)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ScreensAvailableFieldsByScreenId)Get Available Screen Fields `` Returns the fields that can be added to a tab on a screen. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/screens/{screenId}/availableFields endpoint. ### [](#parameters-275)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Screen Id

Number

The ID of the screen.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-274)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-274)For Configurations - [Configurations](#Config) ### [](#throws-274)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ScreensTabsByScreenId)Get All Screen Tabs `` Returns the list of tabs for a screen. **Permissions required:** - **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). - **Administer projects** [project permission](https://confluence.atlassian.com/x/yodKLg) when the project key is specified, providing that the screen is associated with the project through a Screen Scheme and Issue Type Screen Scheme. This operation makes an HTTP GET request to the /rest/api/3/screens/{screenId}/tabs endpoint. ### [](#parameters-276)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Screen Id

Number

The ID of the screen.

Project Key

String

The key of the project.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-275)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-275)For Configurations - [Configurations](#Config) ### [](#throws-275)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ScreensTabsFieldsByScreenIdTabId)Get All Screen Tab Fields `` Returns all fields for a screen tab. **Permissions required:** - **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). - **Administer projects** [project permission](https://confluence.atlassian.com/x/yodKLg) when the project key is specified, providing that the screen is associated with the project through a Screen Scheme and Issue Type Screen Scheme. This operation makes an HTTP GET request to the /rest/api/3/screens/{screenId}/tabs/{tabId}/fields endpoint. ### [](#parameters-277)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Screen Id

Number

The ID of the screen.

Tab Id

Number

The ID of the screen tab.

Project Key

String

The key of the project.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-276)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-276)For Configurations - [Configurations](#Config) ### [](#throws-276)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Screenscheme)Get Screen Schemes `` Returns a paginated list of screen schemes. Only screen schemes used in classic projects are returned. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/screenscheme endpoint. ### [](#parameters-278)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Array of Number

The list of screen scheme IDs. To include multiple IDs, provide an ampersand-separated list. For example, id=10000&id=10001.

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Iterable
Repeatable File Store Iterable
non-repeatable-iterable

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-277)Output

Type

Array of * Any

### [](#for-configurations-277)For Configurations - [Configurations](#Config) ### [](#throws-277)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Search)(Deprecated) Search For Issues Using JQL `` Searches for issues using [JQL](https://support.atlassian.com/jira-software-cloud/docs/what-is-advanced-search-in-jira-cloud/). If the JQL query expression is too large to be encoded as a query parameter, use the \[POST\](#api-rest-api-3-search-post) version of this resource. This operation can be accessed anonymously. **Permissions required:** Issues are included in the response where the user has: - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project containing the issue. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP GET request to the /rest/api/3/search/jql endpoint. ### [](#parameters-279)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

jql

String

The JQL that defines the search. Note:

If no JQL expression is provided, all issues are returned.
username and userkey cannot be used as search terms due to privacy reasons. Use accountId instead.
If a user has hidden their email address in their user profile, partial matches of the email address will not find the user. An exact match is required.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page. To manage page size, Jira may return fewer items per page where a large number of fields are requested. The greatest number of items returned per page is achieved when requesting id or key only.

Validate Query

Enumeration, one of:

STRICT
WARN
NONE
TRUE
FALSE

Determines how to validate the JQL query and treat the validation results. Supported values are:

strict Returns a 400 response code if any errors are found, along with a list of all errors (and warnings).
warn Returns all errors as warnings.
none No validation is performed.
true Deprecated A legacy synonym for strict.
false Deprecated A legacy synonym for warn. Note: If the JQL is not correctly formed a 400 response code is returned, regardless of the validateQuery value.

STRICT

fields

Array of String

A list of fields to return for each issue, use it to retrieve a subset of fields. This parameter accepts a comma-separated list. Expand options include:

*all Returns all fields.
*navigable Returns navigable fields.
Any issue field, prefixed with a minus to exclude.

Examples:

summary,comment Returns only the summary and comments fields.
-description Returns all navigable (default) fields except description.
*all,-comment Returns all fields except comments.

This parameter can be specified multiple times. For example, fields=field1,field2&fields=field3. Note: All navigable fields are returned by default. This differs from [GET issue](#api-rest-api-3-issue-issueIdOrKey-get) where the default is all fields.

expand

String

Use expand to include additional information about issues in the response. This parameter accepts a comma-separated list. Expand options include:

renderedFields Returns field values rendered in HTML format.
names Returns the display name of each field.
schema Returns the schema describing a field type.
transitions Returns all possible transitions for the issue.
operations Returns all possible operations for the issue.
editmeta Returns information about how each field can be edited.
changelog Returns a list of recent updates to an issue, sorted by date, starting from the most recent.
versionedRepresentations Instead of fields, returns versionedRepresentations a JSON array containing each version of a field’s value, with the highest numbered item representing the most recent version.

properties

Array of String

A list of issue property keys for issue properties to include in the results. This parameter accepts a comma-separated list. Multiple properties can also be provided using an ampersand separated list. For example, properties=prop1,prop2&properties=prop3. A maximum of 5 issue property keys can be specified.

Fields By Keys

Boolean

Reference fields by their key (rather than ID).

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-278)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-278)For Configurations - [Configurations](#Config) ### [](#throws-278)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3SearchPaginated)Search For Issues Using JQL (Paginated) `` Searches for issues using [JQL](https://support.atlassian.com/jira-software-cloud/docs/what-is-advanced-search-in-jira-cloud/). If the JQL query expression is too large to encode as a query parameter, use the POST version of this resource. This operation can be accessed anonymously. This operation makes an HTTP GET request to the `/rest/api/3/search/jql` endpoint. ### [](#parameters-280)Parameters

Name Type Description Default Value Required

Configuration

String

Name of the configuration to use.

jql

String

The JQL that defines the search.

* If no JQL expression is provided, all issues are returned.

* username and userkey cannot be used as search terms due to privacy reasons. Use accountId instead.

* If a user hides their email address in their user profile, partial matches of the email address will not find the user. An exact match is required.

Start At (Deprecated)

Number

Index of the first item to return in a page of results (page offset).

Max Results

Number

Maximum number of items to return per page. To manage page size, Jira may return fewer items per page when a large number of fields are requested. Return a large number of fields per page by requesting id or key.

Validate Query

Enumeration, one of:

STRICT
WARN
NONE
TRUE
FALSE

Determines how to validate the JQL query and treat the validation results. If the JQL is not correctly formed, a 400 response code is returned regardless of the validateQuery value.

The supported values are:

* strict

Returns a 400 response code and a list of all errors and warnings.

* warn

Returns all errors as warnings.

* none

No validation is performed.

* true

Deprecated A legacy synonym for strict.

* false

Deprecated A legacy synonym for warn.

STRICT

fields

Array of String

List of fields to return for each issue. Use it to retrieve a subset of fields. This parameter accepts a comma-separated list. All navigable fields are returned by default. This differs from GET issue where the default is all fields.

Expand options include:

* *all

Returns all fields.

* *navigable

Returns navigable fields.

* Any issue field, prefixed with a minus to exclude.

Examples:

* summary,comment

Returns only the summary and comments fields.

* -description

Returns all navigable (default) fields except description.

* *all,-comment

Returns all fields except comments. This parameter may be specified multiple times. For example, fields=field1,field2&fields=field3.

expand

String

Use this parameter to include additional information about issues in the response. This parameter accepts a comma-separated list.

Expand options include:

* renderedFields

Returns field values rendered in HTML format.

* names

Returns the display name of each field.

* schema

Returns the schema describing a field type.

* transitions

Returns all possible transitions for the issue.

* operations

Returns all possible operations for the issue.

* editmeta

Returns information about how each field can be edited.

* changelog

Returns a list of recent updates to an issue, sorted by date, starting from the most recent.

* versionedRepresentations

Returns versionedRepresentations, which is a JSON array that contains each version of a field’s value, with the highest numbered item representing the most recent version.

properties

Array of String

List of issue property keys for issue properties to include in the results. This parameter accepts a comma-separated list. Multiple properties can also be provided using an ampersand-separated list. For example, properties=prop1,prop2&properties=prop3. A maximum of five issue property keys can be specified.

Fields By Keys

Boolean

Reference fields by their key (rather than ID).

false

Output Mime Type

String

Mime type of the payload that the operation outputs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Iterable
Repeatable File Store Iterable
non-repeatable-iterable

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

How long Mule waits for a response to complete before the response times out.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit for the Response Timeout field.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors.

### [](#output-279)Output

Type

Array of Any

### [](#for-configurations-279)For Configurations - [Configurations](#Config) ### [](#throws-279)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3SecuritylevelById)Get Issue Security Level `` Returns details of an issue security level. Use \[Get issue security scheme\](#api-rest-api-3-issuesecurityschemes-id-get) to obtain the IDs of issue security levels associated with the issue security scheme. This operation can be accessed anonymously. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/securitylevel/{id} endpoint. ### [](#parameters-281)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the issue security level.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-280)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-280)For Configurations - [Configurations](#Config) ### [](#throws-280)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3ServerInfo)Get Server Info `` Returns information about the Jira instance. This operation can be accessed anonymously. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/serverInfo endpoint. ### [](#parameters-282)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-281)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-281)For Configurations - [Configurations](#Config) ### [](#throws-281)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3SettingsColumns)Get Issue Navigator Default Columns `` Returns the default issue navigator columns. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/settings/columns endpoint. ### [](#parameters-283)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-282)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-282)For Configurations - [Configurations](#Config) ### [](#throws-282)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Status)Get Statuses `` Returns a list of all statuses associated with workflows. This operation can be accessed anonymously. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/status endpoint. ### [](#parameters-284)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-283)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-283)For Configurations - [Configurations](#Config) ### [](#throws-283)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3StatusByIdOrName)Get Status `` Returns a status. The status must be associated with a workflow to be returned. If a name is used on more than one status, only the status found first is returned. Therefore, identifying the status by its ID may be preferable. This operation can be accessed anonymously. **Permissions required**: None. This operation makes an HTTP GET request to the /rest/api/3/status/{idOrName} endpoint. ### [](#parameters-285)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Id Or Name

String

The ID or name of the status.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-284)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-284)For Configurations - [Configurations](#Config) ### [](#throws-284)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Statuscategory)Get Status Categories `` Returns a list of all status categories. **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/statuscategory endpoint. ### [](#parameters-286)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-285)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-285)For Configurations - [Configurations](#Config) ### [](#throws-285)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3StatuscategoryByIdOrKey)Get Status Category `` Returns a status category. Status categories provided a mechanism for categorizing \[statuses\](#api-rest-api-3-status-idOrName-get). **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/statuscategory/{idOrKey} endpoint. ### [](#parameters-287)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Id Or Key

String

The ID or key of the status category.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-286)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-286)For Configurations - [Configurations](#Config) ### [](#throws-286)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3TaskByTaskId)Get Task `` Returns the status of a \[long-running asynchronous task\](#async). When a task has finished, this operation returns the JSON blob applicable to the task. See the documentation of the operation that created the task for details. Task details are not permanently retained. As of September 2019, details are retained for 14 days, although this period may change without notice. **Permissions required:** Either of: - **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) - Creator of the task This operation makes an HTTP GET request to the /rest/api/3/task/{taskId} endpoint. ### [](#parameters-288)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Task Id

String

The ID of the task.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-287)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-287)For Configurations - [Configurations](#Config) ### [](#throws-287)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3UniversalAvatarTypeOwnerByTypeEntityId)Get Avatars `` Returns the system and custom avatars for a project or issue type. This operation can be accessed anonymously. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/universal\_avatar/type/{type}/owner/{entityId} endpoint. ### [](#parameters-289)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

type

Enumeration, one of:

PROJECT
ISSUETYPE

The avatar type.

Entity Id

String

The ID of the item the avatar is associated with.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-288)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-288)For Configurations - [Configurations](#Config) ### [](#throws-288)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3User)Get User `` Returns a user. **Permissions required:** **Browse users and groups** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/user endpoint. ### [](#parameters-290)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Account Id

String

The account ID of the user, which uniquely identifies the user across all Atlassian products. For example, 5b10ac8d82e05b22cc7d4ef5. Required.

username

String

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

key

String

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

expand

String

Use expand to include additional information about users in the response. This parameter accepts a comma-separated list. Expand options include:

groups includes all groups and nested groups to which the user belongs.
applicationRoles includes details of all the applications to which the user has access.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-289)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-289)For Configurations - [Configurations](#Config) ### [](#throws-289)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3UserAssignableMultiProjectSearch)Find Bulk Assignable Users `` Returns a list of users who can be assigned issues in one or more projects. The list may be restricted to users whose attributes match a string. This operation takes the users in the range defined by `startAt` and `maxResults`, up to the thousandth user, and then returns only the users from that range that can be assigned issues in the projects. This means the operation usually returns fewer users than specified in `maxResults`. To get all the users who can be assigned issues in the projects, use \[Get all users\](#api-rest-api-3-users-search-get) and filter the records in your code. This operation can be accessed anonymously. **Permissions required:** None. This operation makes an HTTP GET request to the /rest/api/3/user/assignable/multiProjectSearch endpoint. ### [](#parameters-291)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

query

String

A query string that is matched against user attributes, such as displayName and emailAddress, to find relevant users. The string can match the prefix of the attribute’s value. For example, query=john matches a user with a displayName of John Smith and a user with an emailAddress of johnson@example.com. Required, unless accountId is specified.

username

String

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

Account Id

String

A query string that is matched exactly against user accountId. Required, unless query is specified.

Project Keys

String

A list of project keys (case sensitive). This parameter accepts a comma-separated list.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-290)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-290)For Configurations - [Configurations](#Config) ### [](#throws-290)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3UserAssignableSearch)Find Assignable Users `` Returns a list of users that can be assigned to an issue. Use this operation to find the list of users who can be assigned to: - a new issue, by providing the `projectKeyOrId`. - an updated issue, by providing the `issueKey`. - to an issue during a transition (workflow action), by providing the `issueKey` and the transition ID in `actionDescriptorId`. You can obtain the IDs of an issue’s valid transitions using the `transitions` option in the `expand` parameter of \[Get issue\](#api-rest-api-3-issue-issueIdOrKey-get). In all these cases, you can pass an account ID to determine if a user can be assigned to an issue. The user is returned in the response if they can be assigned to the issue or issue transition. This operation takes the users in the range defined by `startAt` and `maxResults`, up to the thousandth user, and then returns only the users from that range that can be assigned the issue. This means the operation usually returns fewer users than specified in `maxResults`. To get all the users who can be assigned the issue, use \[Get all users\](#api-rest-api-3-users-search-get) and filter the records in your code. **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/user/assignable/search endpoint. ### [](#parameters-292)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

query

String

A query string that is matched against user attributes, such as displayName, and emailAddress, to find relevant users. The string can match the prefix of the attribute’s value. For example, query=john matches a user with a displayName of John Smith and a user with an emailAddress of johnson@example.com. Required, unless username or accountId is specified.

Session Id

String

The sessionId of this request. SessionId is the same until the assignee is set.

username

String

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

Account Id

String

A query string that is matched exactly against user accountId. Required, unless query is specified.

project

String

The project ID or project key (case sensitive). Required, unless issueKey is specified.

Issue Key

String

The key of the issue. Required, unless project is specified.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return. This operation may return less than the maximum number of items even if more are available. The operation fetches users up to the maximum and then, from the fetched users, returns only the users that can be assigned to the issue.

Action Descriptor Id

Number

The ID of the transition.

recommend

Boolean

recommend

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-291)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-291)For Configurations - [Configurations](#Config) ### [](#throws-291)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3UserBulk)Bulk Get Users `` Returns a paginated list of the users specified by one or more account IDs. **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/user/bulk endpoint. ### [](#parameters-293)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

username

Array of String

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

key

Array of String

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

Account Id

Array of String

The account ID of a user. To specify multiple users, pass multiple accountId parameters. For example, accountId=5b10a2844c20165700ede21g&accountId=5b10ac8d82e05b22cc7d4ef5.

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Iterable
Repeatable File Store Iterable
non-repeatable-iterable

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-292)Output

Type

Array of * Any

### [](#for-configurations-292)For Configurations - [Configurations](#Config) ### [](#throws-292)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3UserBulkMigration)Bulk Get Users Migration `` Returns the account IDs for the users specified in the `key` or `username` parameters. Note that multiple `key` or `username` parameters can be specified. **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/user/bulk/migration endpoint. ### [](#parameters-294)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

username

Array of String

Username of a user. To specify multiple users, pass multiple copies of this parameter. For example, username=fred&username=barney. Required if key isn’t provided. Cannot be provided if key is present.

key

Array of String

Key of a user. To specify multiple users, pass multiple copies of this parameter. For example, key=fred&key=barney. Required if username isn’t provided. Cannot be provided if username is present.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-293)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-293)For Configurations - [Configurations](#Config) ### [](#throws-293)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3UserColumns)Get User Default Columns `` Returns the default [issue table columns](https://confluence.atlassian.com/x/XYdKLg) for the user. If `accountId` is not passed in the request, the calling user’s details are returned. **Permissions required:** - **Administer Jira** global permission, to get the column details for any user. - Permission to access Jira, to get the calling user’s column details. This operation makes an HTTP GET request to the /rest/api/3/user/columns endpoint. ### [](#parameters-295)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Account Id

String

The account ID of the user, which uniquely identifies the user across all Atlassian products. For example, 5b10ac8d82e05b22cc7d4ef5.

username

String

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-294)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-294)For Configurations - [Configurations](#Config) ### [](#throws-294)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3UserEmail)Get User Email `` Returns a user’s email address. This API is only available to apps approved by Atlassian, according to these [guidelines](https://community.developer.atlassian.com/t/guidelines-for-requesting-access-to-email-address/27603). This operation makes an HTTP GET request to the /rest/api/3/user/email endpoint. ### [](#parameters-296)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Account Id

String

The account ID of the user, which uniquely identifies the user across all Atlassian products. For example, 5b10ac8d82e05b22cc7d4ef5.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-295)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-295)For Configurations - [Configurations](#Config) ### [](#throws-295)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3UserEmailBulk)Get User Email Bulk `` Returns a user’s email address. This API is only available to apps approved by Atlassian, according to these [guidelines](https://community.developer.atlassian.com/t/guidelines-for-requesting-access-to-email-address/27603). This operation makes an HTTP GET request to the /rest/api/3/user/email/bulk endpoint. ### [](#parameters-297)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Account Id

Array of String

The account IDs of the users for which emails are required. An accountId is an identifier that uniquely identifies the user across all Atlassian products. For example, 5b10ac8d82e05b22cc7d4ef5. Note, this should be treated as an opaque identifier (that is, do not assume any structure in the value).

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-296)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-296)For Configurations - [Configurations](#Config) ### [](#throws-296)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3UserGroups)Get User Groups `` Returns the groups to which a user belongs. **Permissions required:** **Browse users and groups** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP GET request to the /rest/api/3/user/groups endpoint. ### [](#parameters-298)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Account Id

String

The account ID of the user, which uniquely identifies the user across all Atlassian products. For example, 5b10ac8d82e05b22cc7d4ef5.

username

String

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

key

String

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-297)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-297)For Configurations - [Configurations](#Config) ### [](#throws-297)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3UserPermissionSearch)Find Users With All Permissions `` Returns a list of users who fulfill these criteria: - their user attributes match a search string. - they have a set of permissions for a project or issue. If no search string is provided, a list of all users with the permissions is returned. This operation takes the users in the range defined by `startAt` and `maxResults`, up to the thousandth user, and then returns only the users from that range that match the search string and have permission for the project or issue. This means the operation usually returns fewer users than specified in `maxResults`. To get all the users who match the search string and have permission for the project or issue, use \[Get all users\](#api-rest-api-3-users-search-get) and filter the records in your code. This operation can be accessed anonymously. **Permissions required:** - **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg), to get users for any project. - **Administer Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for a project, to get users for that project. This operation makes an HTTP GET request to the /rest/api/3/user/permission/search endpoint. ### [](#parameters-299)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

query

String

username

String

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

Account Id

String

A query string that is matched exactly against user accountId. Required, unless query is specified.

permissions

String

A comma-separated list of permissions. Permissions can be specified as any:

permission returned by [Get all permissions](#api-rest-api-3-permissions-get).
custom project permission added by Connect apps.
(deprecated) one of the following:
ASSIGNABLE\_USER * ASSIGN\_ISSUE
ATTACHMENT\_DELETE\_ALL
ATTACHMENT\_DELETE\_OWN
BROWSE * CLOSE\_ISSUE
COMMENT\_DELETE\_ALL
COMMENT\_DELETE\_OWN
COMMENT\_EDIT\_ALL
COMMENT\_EDIT\_OWN
COMMENT\_ISSUE
CREATE\_ATTACHMENT
CREATE\_ISSUE
DELETE\_ISSUE
EDIT\_ISSUE
LINK\_ISSUE
MANAGE\_WATCHER\_LIST
MODIFY\_REPORTER
MOVE\_ISSUE
PROJECT\_ADMIN
RESOLVE\_ISSUE
SCHEDULE\_ISSUE
SET\_ISSUE\_SECURITY
TRANSITION\_ISSUE
VIEW\_VERSION\_CONTROL
VIEW\_VOTERS\_AND\_WATCHERS
VIEW\_WORKFLOW\_READONLY
WORKLOG\_DELETE\_ALL
WORKLOG\_DELETE\_OWN
WORKLOG\_EDIT\_ALL
WORKLOG\_EDIT\_OWN
WORK\_ISSUE

Issue Key

String

The issue key for the issue.

Project Key

String

The project key for the project (case sensitive).

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-298)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-298)For Configurations - [Configurations](#Config) ### [](#throws-298)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3UserPicker)Find Users For Picker `` Returns a list of users whose attributes match the query term. The returned object includes the `html` field where the matched query term is highlighted with the HTML strong tag. A list of account IDs can be provided to exclude users from the results. This operation takes the users in the range defined by `maxResults`, up to the thousandth user, and then returns only the users from that range that match the query term. This means the operation usually returns fewer users than specified in `maxResults`. To get all the users who match the query term, use \[Get all users\](#api-rest-api-3-users-search-get) and filter the records in your code. This operation can be accessed anonymously. **Permissions required:** **Browse users and groups** [global permission](https://confluence.atlassian.com/x/x4dKLg). Anonymous calls and calls by users without the required permission return search results for an exact name match only. This operation makes an HTTP GET request to the /rest/api/3/user/picker endpoint. ### [](#parameters-300)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

query

String

Max Results

Number

The maximum number of items to return. The total number of matched users is returned in total.

Show Avatar

Boolean

Include the URI to the user’s avatar.

false

exclude

Array of String

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

Exclude Account Ids

Array of String

A list of account IDs to exclude from the search results. This parameter accepts a comma-separated list. Multiple account IDs can also be provided using an ampersand-separated list. For example, excludeAccountIds=5b10a2844c20165700ede21g,5b10a0effa615349cb016cd8&excludeAccountIds=5b10ac8d82e05b22cc7d4ef5. Cannot be provided with exclude.

Avatar Size

String

Avatar Size

Exclude Connect Users

Boolean

Exclude Connect Users

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-299)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-299)For Configurations - [Configurations](#Config) ### [](#throws-299)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3UserProperties)Get User Property Keys `` Returns the keys of all properties for a user. Note: This operation does not access the [user properties](https://support.atlassian.com/user-management/docs/update-roles-and-properties-for-jira-users/) created and maintained in Jira. **Permissions required:** - **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg), to access the property keys on any user. - Access to Jira, to access the calling user’s property keys. This operation makes an HTTP GET request to the /rest/api/3/user/properties endpoint. ### [](#parameters-301)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Account Id

String

The account ID of the user, which uniquely identifies the user across all Atlassian products. For example, 5b10ac8d82e05b22cc7d4ef5.

User Key

String

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

username

String

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-300)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-300)For Configurations - [Configurations](#Config) ### [](#throws-300)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3UserPropertiesByPropertyKey)Get User Property `` Returns the value of a user’s property. If no property key is provided \[Get user property keys\](#api-rest-api-3-user-properties-get) is called. Note: This operation does not access the \[user properties\](https://docs.mulesoft.com/jira-connector/latest/[https://support.atlassian.com/user-management/docs/update-roles-and-properties-for-jira-users/](https://support.atlassian.com/user-management/docs/update-roles-and-properties-for-jira-users/)) created and maintained in Jira. **Permissions required:** - **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg), to get a property from any user. - Access to Jira, to get a property from the calling user’s record. This operation makes an HTTP GET request to the /rest/api/3/user/properties/{propertyKey} endpoint. ### [](#parameters-302)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Property Key

String

The key of the user’s property.

Account Id

String

The account ID of the user, which uniquely identifies the user across all Atlassian products. For example, 5b10ac8d82e05b22cc7d4ef5.

User Key

String

username

String

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-301)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-301)For Configurations - [Configurations](#Config) ### [](#throws-301)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3UserSearch)Find Users `` Returns a list of users that match the search string and property. This operation takes the users in the range defined by `startAt` and `maxResults`, up to the thousandth user, and then returns only the users from that range that match the search string and property. This means the operation usually returns fewer users than specified in `maxResults`. To get all the users who match the search string and property, use \[Get all users\](#api-rest-api-3-users-search-get) and filter the records in your code. This operation can be accessed anonymously. **Permissions required:** **Browse users and groups** [global permission](https://confluence.atlassian.com/x/x4dKLg). Anonymous calls or calls by users without the required permission return empty search results. This operation makes an HTTP GET request to the /rest/api/3/user/search endpoint. ### [](#parameters-303)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

query

String

A query string that is matched against user attributes ( displayName, and emailAddress) to find relevant users. The string can match the prefix of the attribute’s value. For example, query=john matches a user with a displayName of John Smith and a user with an emailAddress of johnson@example.com. Required, unless accountId or property is specified.

username

String

username

Account Id

String

A query string that is matched exactly against a user accountId. Required, unless query or property is specified.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

property

String

A query string used to search properties. Property keys are specified by path, so property keys containing dot (.) or equals (=) characters cannot be used. The query string cannot be specified using a JSON object. Example: To search for the value of nested from {"something":{"nested":1,"other":2}} use thepropertykey.something.nested=1. Required, unless accountId or query is specified.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-302)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-302)For Configurations - [Configurations](#Config) ### [](#throws-302)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3UserSearchQuery)Find Users By Query `` Finds users with a structured query and returns a paginated list of user details. This operation takes the users in the range defined by `startAt` and `maxResults`, up to the thousandth user, and then returns only the users from that range that match the structured query. This means the operation usually returns fewer users than specified in `maxResults`. To get all the users who match the structured query, use \[Get all users\](#api-rest-api-3-users-search-get) and filter the records in your code. **Permissions required:** **Browse users and groups** [global permission](https://confluence.atlassian.com/x/x4dKLg). The query statements are: - `is assignee of PROJ` Returns the users that are assignees of at least one issue in project **PROJ**. - `is assignee of (PROJ-1, PROJ-2)` Returns users that are assignees on the issues **PROJ-1** or **PROJ-2**. - `is reporter of (PROJ-1, PROJ-2)` Returns users that are reporters on the issues **PROJ-1** or **PROJ-2**. - `is watcher of (PROJ-1, PROJ-2)` Returns users that are watchers on the issues **PROJ-1** or **PROJ-2**. - `is voter of (PROJ-1, PROJ-2)` Returns users that are voters on the issues **PROJ-1** or **PROJ-2**. - `is commenter of (PROJ-1, PROJ-2)` Returns users that have posted a comment on the issues **PROJ-1** or **PROJ-2**. - `is transitioner of (PROJ-1, PROJ-2)` Returns users that have performed a transition on issues **PROJ-1** or **PROJ-2**. - `[propertyKey].entity.property.path is "property value"` Returns users with the entity property value. The list of issues can be extended as needed, as in **(PROJ-1, PROJ-2, … PROJ-n)**. Statements can be combined using the `AND` and `OR` operators to form more complex queries. For example: `is assignee of PROJ AND [propertyKey].entity.property.path is "property value"` This operation makes an HTTP GET request to the /rest/api/3/user/search/query endpoint. ### [](#parameters-304)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

query

String

The search query.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

100

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-303)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-303)For Configurations - [Configurations](#Config) ### [](#throws-303)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3UserSearchQueryKey)Find User Keys By Query `` Finds users with a structured query and returns a paginated list of user keys. This operation takes the users in the range defined by `startAt` and `maxResults`, up to the thousandth user, and then returns only the users from that range that match the structured query. This means the operation usually returns fewer users than specified in `maxResults`. To get all the users who match the structured query, use \[Get all users\](#api-rest-api-3-users-search-get) and filter the records in your code. **Permissions required:** **Browse users and groups** [global permission](https://confluence.atlassian.com/x/x4dKLg). The query statements are: - `is assignee of PROJ` Returns the users that are assignees of at least one issue in project **PROJ**. - `is assignee of (PROJ-1, PROJ-2)` Returns users that are assignees on the issues **PROJ-1** or **PROJ-2**. - `is reporter of (PROJ-1, PROJ-2)` Returns users that are reporters on the issues **PROJ-1** or **PROJ-2**. - `is watcher of (PROJ-1, PROJ-2)` Returns users that are watchers on the issues **PROJ-1** or **PROJ-2**. - `is voter of (PROJ-1, PROJ-2)` Returns users that are voters on the issues **PROJ-1** or **PROJ-2**. - `is commenter of (PROJ-1, PROJ-2)` Returns users that have posted a comment on the issues **PROJ-1** or **PROJ-2**. - `is transitioner of (PROJ-1, PROJ-2)` Returns users that have performed a transition on issues **PROJ-1** or **PROJ-2**. - `[propertyKey].entity.property.path is "property value"` Returns users with the entity property value. The list of issues can be extended as needed, as in **(PROJ-1, PROJ-2, … PROJ-n)**. Statements can be combined using the `AND` and `OR` operators to form more complex queries. For example: `is assignee of PROJ AND [propertyKey].entity.property.path is "property value"` This operation makes an HTTP GET request to the /rest/api/3/user/search/query/key endpoint. ### [](#parameters-305)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

query

String

The search query.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

100

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-304)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-304)For Configurations - [Configurations](#Config) ### [](#throws-304)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3UserViewissueSearch)Find Users With Browse Permission `` Returns a list of users who fulfill these criteria: - their user attributes match a search string. - they have permission to browse issues. Use this resource to find users who can browse: - an issue, by providing the `issueKey`. - any issue in a project, by providing the `projectKey`. This operation takes the users in the range defined by `startAt` and `maxResults`, up to the thousandth user, and then returns only the users from that range that match the search string and have permission to browse issues. This means the operation usually returns fewer users than specified in `maxResults`. To get all the users who match the search string and have permission to browse issues, use \[Get all users\](#api-rest-api-3-users-search-get) and filter the records in your code. This operation can be accessed anonymously. **Permissions required:** **Browse users and groups** [global permission](https://confluence.atlassian.com/x/x4dKLg). Anonymous calls and calls by users without the required permission return empty search results. This operation makes an HTTP GET request to the /rest/api/3/user/viewissue/search endpoint. ### [](#parameters-306)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

query

String

username

String

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

Account Id

String

A query string that is matched exactly against user accountId. Required, unless query is specified.

Issue Key

String

The issue key for the issue. Required, unless projectKey is specified.

Project Key

String

The project key for the project (case sensitive). Required, unless issueKey is specified.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-305)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-305)For Configurations - [Configurations](#Config) ### [](#throws-305)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Users)Get All Users Default `` Returns a list of all (active and inactive) users. **Permissions required:** **Browse users and groups** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/users endpoint. ### [](#parameters-307)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return.

Max Results

Number

The maximum number of items to return.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-306)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-306)For Configurations - [Configurations](#Config) ### [](#throws-306)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3UsersSearch)Get All Users `` Returns a list of all (active and inactive) users. **Permissions required:** **Browse users and groups** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP GET request to the /rest/api/3/users/search endpoint. ### [](#parameters-308)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return.

Max Results

Number

The maximum number of items to return.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-307)Output

Type

Array of Any

Attributes Type

Http Response Attributes

### [](#for-configurations-307)For Configurations - [Configurations](#Config) ### [](#throws-307)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3VersionById)Get Version `` Returns a project version. This operation can be accessed anonymously. **Permissions required:** **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project containing the version. This operation makes an HTTP GET request to the /rest/api/3/version/{id} endpoint. ### [](#parameters-309)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the version.

expand

String

Use expand to include additional information about version in the response. This parameter accepts a comma-separated list. Expand options include:

operations Returns the list of operations available for this version.
issuesstatus Returns the count of issues in this version for each of the status categories to do, in progress, done, and unmapped. The unmapped property represents the number of issues with a status other than to do, in progress, and done.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-308)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-308)For Configurations - [Configurations](#Config) ### [](#throws-308)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3VersionRelatedIssueCountsById)Get Version Related Issues `` Returns the following counts for a version: - Number of issues where the `fixVersion` is set to the version. - Number of issues where the `affectedVersion` is set to the version. - Number of issues where a version custom field is set to the version. This operation can be accessed anonymously. **Permissions required:** **Browse projects** project permission for the project that contains the version. This operation makes an HTTP GET request to the /rest/api/3/version/{id}/relatedIssueCounts endpoint. ### [](#parameters-310)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the version.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-309)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-309)For Configurations - [Configurations](#Config) ### [](#throws-309)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3VersionUnresolvedIssueCountById)Get Version Unresolved Issues `` Returns counts of the issues and unresolved issues for the project version. This operation can be accessed anonymously. **Permissions required:** **Browse projects** project permission for the project that contains the version. This operation makes an HTTP GET request to the /rest/api/3/version/{id}/unresolvedIssueCount endpoint. ### [](#parameters-311)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the version.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-310)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-310)For Configurations - [Configurations](#Config) ### [](#throws-310)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Webhook)Get Dynamic Webhooks For App `` Returns a paginated list of the webhooks registered by the calling app. **Permissions required:** Only [Connect apps](https://developer.atlassian.com/cloud/jira/platform/index/) can use this operation. This operation makes an HTTP GET request to the /rest/api/3/webhook endpoint. ### [](#parameters-312)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

100

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-311)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-311)For Configurations - [Configurations](#Config) ### [](#throws-311)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3WebhookFailed)Get Failed Webhooks `` Returns webhooks that have recently failed to be delivered to the requesting app after the maximum number of retries. After 72 hours the failure may no longer be returned by this operation. The oldest failure is returned first. This method uses a cursor-based pagination. To request the next page use the failure time of the last webhook on the list as the `failedAfter` value or use the URL provided in `next`. **Permissions required:** Only [Connect apps](https://developer.atlassian.com/cloud/jira/platform/index/) can use this operation. This operation makes an HTTP GET request to the /rest/api/3/webhook/failed endpoint. ### [](#parameters-313)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Max Results

Number

The maximum number of webhooks to return per page. If obeying the maxResults directive would result in records with the same failure time being split across pages, the directive is ignored and all records with the same failure time included on the page.

after

Number

The time after which any webhook failure must have occurred for the record to be returned, expressed as milliseconds since the UNIX epoch.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-312)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-312)For Configurations - [Configurations](#Config) ### [](#throws-312)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3WorkflowRuleConfig)Get Workflow Transition Rule Configurations `` Returns a paginated list of workflows with transition rules. The workflows can be filtered to return only those containing workflow transition rules: - of one or more transition rule types, such as [workflow post functions](https://developer.atlassian.com/cloud/jira/platform/modules/workflow-post-function/). - matching one or more transition rule keys. Only workflows containing transition rules created by the calling Connect app are returned. However, if a workflow is returned all transition rules that match the filters are returned for that workflow. Due to server-side optimizations, workflows with an empty list of rules may be returned; these workflows can be ignored. **Permissions required:** Only Connect apps can use this operation. This operation makes an HTTP GET request to the /rest/api/3/workflow/rule/config endpoint. ### [](#parameters-314)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

types

Array of Enumeration, one of:

POSTFUNCTION
CONDITION
VALIDATOR

The types of the transition rules to return.

keys

Array of String

The transition rule class keys, as defined in the Connect app descriptor, of the transition rules to return.

expand

String

Use expand to include additional information in the response. This parameter accepts transition, which, for each rule, returns information about the transition the rule is assigned to.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-313)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-313)For Configurations - [Configurations](#Config) ### [](#throws-313)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3WorkflowSearch)Get Workflows Paginated `` Returns a paginated list of published classic workflows. When workflow names are specified, details of those workflows are returned. Otherwise, all published classic workflows are returned. This operation does not return next-gen workflows. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/workflow/search endpoint. ### [](#parameters-315)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Workflow Name

Array of String

The name of a workflow to return.

expand

String

Use expand to include additional information in the response. This parameter accepts a comma-separated list. Expand options include:

transitions For each workflow, returns information about the transitions inside the workflow.
transitions.rules For each workflow transition, returns information about its rules. Transitions are included automatically if this expand is requested.
statuses For each workflow, returns information about the statuses inside the workflow.
statuses.properties For each workflow status, returns information about its properties. Statuses are included automatically if this expand is requested.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-314)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-314)For Configurations - [Configurations](#Config) ### [](#throws-314)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3WorkflowTransitionsPropertiesByTransitionId)Get Workflow Transition Properties `` Returns the properties on a workflow transition. Transition properties are used to change the behavior of a transition. For more information, see [Transition properties](https://confluence.atlassian.com/x/zIhKLg#Advancedworkflowconfiguration-transitionproperties) and [Workflow properties](https://confluence.atlassian.com/x/JYlKLg). **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/workflow/transitions/{transitionId}/properties endpoint. ### [](#parameters-316)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Transition Id

Number

The ID of the transition. To get the ID, view the workflow in text mode in the Jira administration console. The ID is shown next to the transition.

Include Reserved Keys

Boolean

Some properties with keys that have the jira. prefix are reserved, which means they are not editable. To include these properties in the results, set this parameter to true.

false

key

String

The key of the property being returned, also known as the name of the property. If this parameter is not specified, all properties on the transition are returned.

Workflow Name

String

The name of the workflow that the transition belongs to.

Workflow Mode

Enumeration, one of:

LIVE
DRAFT

The workflow status. Set to live for active and inactive workflows, or draft for draft workflows.

LIVE

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-315)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-315)For Configurations - [Configurations](#Config) ### [](#throws-315)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3Workflowscheme)Get All Workflow Schemes `` Returns a paginated list of all workflow schemes, not including draft workflow schemes. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/workflowscheme endpoint. ### [](#parameters-317)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Start At

Number

The index of the first item to return in a page of results (page offset).

Max Results

Number

The maximum number of items to return per page.

Output Mime Type

String

The MIME type of the payload that this operation outputs.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Iterable
Repeatable File Store Iterable
non-repeatable-iterable

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-316)Output

Type

Array of * Any

### [](#for-configurations-316)For Configurations - [Configurations](#Config) ### [](#throws-316)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3WorkflowschemeById)Get Workflow Scheme `` Returns a workflow scheme. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/workflowscheme/{id} endpoint. ### [](#parameters-318)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the workflow scheme. Find this ID by editing the desired workflow scheme in Jira. The ID is shown in the URL as schemeId. For example, schemeId=10301.

Return Draft If Exists

Boolean

Returns the workflow scheme’s draft rather than scheme itself, if set to true. If the workflow scheme does not have a draft, then the workflow scheme is returned.

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-317)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-317)For Configurations - [Configurations](#Config) ### [](#throws-317)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3WorkflowschemeDefaultById)Get Default Workflow `` Returns the default workflow for a workflow scheme. The default workflow is the workflow that is assigned any issue types that have not been mapped to any other workflow. The default workflow has **All Unassigned Issue Types** listed in its issue types for the workflow scheme in Jira. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/workflowscheme/{id}/default endpoint. ### [](#parameters-319)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the workflow scheme.

Return Draft If Exists

Boolean

Set to true to return the default workflow for the workflow scheme’s draft rather than scheme itself. If the workflow scheme does not have a draft, then the default workflow for the workflow scheme is returned.

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-318)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-318)For Configurations - [Configurations](#Config) ### [](#throws-318)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3WorkflowschemeDraftById)Get Workflow Scheme Draft `` Returns the draft workflow scheme for an active workflow scheme. Draft workflow schemes allow changes to be made to the active workflow schemes: When an active workflow scheme is updated, a draft copy is created. The draft is modified, then the changes in the draft are copied back to the active workflow scheme. See [Configuring workflow schemes](https://confluence.atlassian.com/x/tohKLg) for more information. Note: - Only active workflow schemes can have draft workflow schemes. - An active workflow scheme can only have one draft workflow scheme. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/workflowscheme/{id}/draft endpoint. ### [](#parameters-320)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the active workflow scheme that the draft was created from.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-319)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-319)For Configurations - [Configurations](#Config) ### [](#throws-319)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3WorkflowschemeDraftDefaultById)Get Draft Default Workflow `` Returns the default workflow for a workflow scheme’s draft. The default workflow is the workflow that is assigned any issue types that have not been mapped to any other workflow. The default workflow has **All Unassigned Issue Types** listed in its issue types for the workflow scheme in Jira. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/workflowscheme/{id}/draft/default endpoint. ### [](#parameters-321)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the workflow scheme that the draft belongs to.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-320)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-320)For Configurations - [Configurations](#Config) ### [](#throws-320)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3WorkflowschemeDraftIssuetypeByIdIssueType)Get Workflow Scheme Draft Issue Type `` Returns the issue type-workflow mapping for an issue type in a workflow scheme’s draft. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/workflowscheme/{id}/draft/issuetype/{issueType} endpoint. ### [](#parameters-322)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the workflow scheme that the draft belongs to.

Issue Type

String

The ID of the issue type.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-321)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-321)For Configurations - [Configurations](#Config) ### [](#throws-321)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3WorkflowschemeDraftWorkflowById)Get Draft Workflow `` Returns the workflow-issue type mappings for a workflow scheme’s draft. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/workflowscheme/{id}/draft/workflow endpoint. ### [](#parameters-323)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the workflow scheme that the draft belongs to.

Workflow Name

String

The name of a workflow in the scheme. Limits the results to the workflow-issue type mapping for the specified workflow.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-322)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-322)For Configurations - [Configurations](#Config) ### [](#throws-322)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3WorkflowschemeIssuetypeByIdIssueType)Get Workflow Scheme Issue Type `` Returns the issue type-workflow mapping for an issue type in a workflow scheme. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/workflowscheme/{id}/issuetype/{issueType} endpoint. ### [](#parameters-324)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the workflow scheme.

Issue Type

String

The ID of the issue type.

Return Draft If Exists

Boolean

Returns the mapping from the workflow scheme’s draft rather than the workflow scheme, if set to true. If no draft exists, the mapping from the workflow scheme is returned.

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-323)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-323)For Configurations - [Configurations](#Config) ### [](#throws-323)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3WorkflowschemeProject)Get Workflow Scheme Project Associations `` Returns a list of the workflow schemes associated with a list of projects. Each returned workflow scheme includes a list of the requested projects associated with it. Any next-gen or non-existent projects in the request are ignored and no errors are returned. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/workflowscheme/project endpoint. ### [](#parameters-325)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id

Array of Number

The ID of a project to return the workflow schemes for. To include multiple projects, provide an ampersand-Jim: oneseparated list. For example, projectId=10000&projectId=10001.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-324)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-324)For Configurations - [Configurations](#Config) ### [](#throws-324)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3WorkflowschemeWorkflowById)Get Workflow `` Returns the workflow-issue type mappings for a workflow scheme. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP GET request to the /rest/api/3/workflowscheme/{id}/workflow endpoint. ### [](#parameters-326)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the workflow scheme.

Workflow Name

String

The name of a workflow in the scheme. Limits the results to the workflow-issue type mapping for the specified workflow.

Return Draft If Exists

Boolean

Returns the mapping from the workflow scheme’s draft rather than the workflow scheme, if set to true. If no draft exists, the mapping from the workflow scheme is returned.

false

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-325)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-325)For Configurations - [Configurations](#Config) ### [](#throws-325)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3WorklogDeleted)Get Ids Of Worklogs Deleted Since `` Returns a list of IDs and delete timestamps for worklogs deleted after a date and time. This resource is paginated, with a limit of 1000 worklogs per page. Each page lists worklogs from oldest to youngest. If the number of items in the date range exceeds 1000, `until` indicates the timestamp of the youngest item on the page. Also, `nextPage` provides the URL for the next page of worklogs. The `lastPage` parameter is set to true on the last page of worklogs. This resource does not return worklogs deleted during the minute preceding the request. **Permissions required:** Permission to access Jira. This operation makes an HTTP GET request to the /rest/api/3/worklog/deleted endpoint. ### [](#parameters-327)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

since

Number

The date and time, as a UNIX timestamp in milliseconds, after which deleted worklogs are returned.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-326)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-326)For Configurations - [Configurations](#Config) ### [](#throws-326)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestApi3WorklogUpdated)Get Ids Of Worklogs Modified Since `` Returns a list of IDs and update timestamps for worklogs updated after a date and time. This resource is paginated, with a limit of 1000 worklogs per page. Each page lists worklogs from oldest to youngest. If the number of items in the date range exceeds 1000, `until` indicates the timestamp of the youngest item on the page. Also, `nextPage` provides the URL for the next page of worklogs. The `lastPage` parameter is set to true on the last page of worklogs. This resource does not return worklogs updated during the minute preceding the request. **Permissions required:** Permission to access Jira, however, worklogs are only returned where either of the following is true: - the worklog is set as **Viewable by All Users**. - the user is a member of a project role or group with permission to view the worklog. This operation makes an HTTP GET request to the /rest/api/3/worklog/updated endpoint. ### [](#parameters-328)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

since

Number

The date and time, as a UNIX timestamp in milliseconds, after which updated worklogs are returned.

expand

String

Use expand to include additional information about worklogs in the response. This parameter accepts properties that returns the properties of each worklog.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-327)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-327)For Configurations - [Configurations](#Config) ### [](#throws-327)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestAtlassianConnect1AddonsPropertiesByAddonKey)Addon Properties Resource get Addon Properties get `` Gets all the properties of an app. **Permissions required:** Only a Connect app whose key matches `addonKey` can make this request. This operation makes an HTTP GET request to the /rest/atlassian-connect/1/addons/{addonKey}/properties endpoint. ### [](#parameters-329)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Addon Key

String

The key of the app, as defined in its descriptor.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-328)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-328)For Configurations - [Configurations](#Config) ### [](#throws-328)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestAtlassianConnect1AddonsPropertiesByAddonKeyPropertyKey)Addon Properties Resource get Addon Property get `` Returns the key and value of an app’s property. **Permissions required:** Only a Connect app whose key matches `addonKey` can make this request. This operation makes an HTTP GET request to the /rest/atlassian-connect/1/addons/{addonKey}/properties/{propertyKey} endpoint. ### [](#parameters-330)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Addon Key

String

The key of the app, as defined in its descriptor.

Property Key

String

The key of the property.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-329)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-329)For Configurations - [Configurations](#Config) ### [](#throws-329)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#GetRestAtlassianConnect1AppModuleDynamic)Dynamic Modules Resource get Modules get `` Returns all modules registered dynamically by the calling app. **Permissions required:** Only Connect apps can make this request. This operation makes an HTTP GET request to the /rest/atlassian-connect/1/app/module/dynamic endpoint. ### [](#parameters-331)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-330)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-330)For Configurations - [Configurations](#Config) ### [](#throws-330)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#Unauthorize)Unauthorize `` Deletes all the access token information of a given resource owner ID so that it’s impossible to execute any operation for that user without repeating the authorization dance. ### [](#parameters-332)Parameters

Name

Type

Description

Default Value

Required

Configuration

String

The name of the configuration to use.

Resource Owner Id

String

The id of the resource owner which access should be invalidated

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

### [](#for-configurations-331)For Configurations - [Configurations](#Config) ## [](#UpdateRestApi3ApplicationPropertiesById)Set Application Property `` Changes the value of an application property. For example, you can change the value of the `jira.clone.prefix` from its default value of **CLONE -** to **Clone -** if you prefer sentence case capitalization. Editable properties are described below along with their default values. ### [](#advanced-settings)Advanced settings The advanced settings below are also accessible in [Jira](https://confluence.atlassian.com/x/vYXKM):

Key Description Default value

jira.clone.prefix

The string of text prefixed to the title of a cloned issue.

CLONE -

jira.date.picker.java.format

The date format for the Java (server-side) generated dates. This must be the same as the jira.date.picker.javascript.format format setting.

d/MMM/yy

jira.date.picker.javascript.format

The date format for the JavaScript (client-side) generated dates. This must be the same as the jira.date.picker.java.format format setting.

%e/%b/%y

jira.date.time.picker.java.format

The date format for the Java (server-side) generated date times. This must be the same as the jira.date.time.picker.javascript.format format setting.

dd/MMM/yy h:mm a

jira.date.time.picker.javascript.format

The date format for the JavaScript (client-side) generated date times. This must be the same as the jira.date.time.picker.java.format format setting.

%e/%b/%y %I:%M %p

jira.issue.actions.order

The default order of actions (such as Comments or Change history) displayed on the issue view.

asc

jira.table.cols.subtasks

The columns to show while viewing subtask issues in a table. For example, a list of subtasks on an issue.

issuetype, status, assignee, progress

jira.view.issue.links.sort.order

The sort order of the list of issue links on the issue view.

type, status, priority

jira.comment.collapsing.minimum.hidden

The minimum number of comments required for comment collapsing to occur. A value of 0 disables comment collapsing.

4

jira.newsletter.tip.delay.days

The number of days before a prompt to sign up to the Jira Insiders newsletter is shown. A value of -1 disables this feature.

7

### [](#look-and-feel)Look and feel The settings listed below adjust the [look and feel](https://confluence.atlassian.com/x/VwCLLg):

Key Description Default value

jira.lf.date.time

The time format.

h:mm a

jira.lf.date.day

The day format.

EEEE h:mm a

jira.lf.date.complete

The date and time format.

dd/MMM/yy h:mm a

jira.lf.date.dmy

The date format.

dd/MMM/yy

jira.date.time.picker.use.iso8061

When enabled, sets Monday as the first day of the week in the date picker, as specified by the ISO8601 standard.

false

jira.lf.logo.url

The URL of the logo image file.

/images/icon-jira-logo.png

jira.lf.logo.show.application.title

Controls the visibility of the application title on the sidebar.

false

jira.lf.favicon.url

The URL of the favicon.

/favicon.ico

jira.lf.favicon.hires.url

The URL of the high-resolution favicon.

/images/64jira.png

jira.lf.top.adg3.bgcolour

The background color of the sidebar.

#0747A6

jira.lf.top.adg3.textcolour

The color of the text and logo of the sidebar.

#DEEBFF

jira.lf.hero.button.base.bg.colour

The background color of the hero button.

#3b7fc4

jira.title

The text for the application title. The application title can also be set in General settings.

Jira

jira.option.globalsharing

Whether filters and dashboards can be shared with anyone signed into Jira.

true

xflow.product.suggestions.enabled

Whether to expose product suggestions for other Atlassian products within Jira.

true

### [](#other-settings)Other settings

Key Description Default value

jira.issuenav.criteria.autoupdate

Whether instant updates to search criteria is active.

true

**Note**: Be careful when changing [application properties and advanced settings](https://confluence.atlassian.com/x/vYXKM). **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP PUT request to the /rest/api/3/application-properties/{id} endpoint. ### [](#parameters-333)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The key of the application property to update.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-331)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-332)For Configurations - [Configurations](#Config) ### [](#throws-331)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3CommentPropertiesByCommentIdPropertyKey)Set Comment Property `` Creates or updates the value of a property for a comment. Use this resource to store custom data against a comment. The value of the request body must be a \[valid\](https://docs.mulesoft.com/jira-connector/latest/[https://datatracker.ietf.org/doc/html/rfc4627](https://datatracker.ietf.org/doc/html/rfc4627)), non-empty JSON blob. The maximum length is 32768 characters. **Permissions required:** Either of: - **Edit All Comments** [project permission](https://confluence.atlassian.com/x/yodKLg) to create or update the value of a property on any comment. - **Edit Own Comments** [project permission](https://confluence.atlassian.com/x/yodKLg) to create or update the value of a property on a comment created by the user. Also, when the visibility of a comment is restricted to a role or group the user must be a member of that role or group. This operation makes an HTTP PUT request to the /rest/api/3/comment/{commentId}/properties/{propertyKey} endpoint. ### [](#parameters-334)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Comment Id

String

The ID of the comment.

Property Key

String

The key of the property. The maximum length is 255 characters.

Body

Binary

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-332)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-333)For Configurations - [Configurations](#Config) ### [](#throws-332)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3ComponentById)Update Component `` Updates a component. Any fields included in the request are overwritten. If `leadAccountId` is an empty string ("") the component lead is removed. This operation can be accessed anonymously. **Permissions required:** **Administer projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project containing the component or **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP PUT request to the /rest/api/3/component/{id} endpoint. ### [](#parameters-335)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the component.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-333)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-334)For Configurations - [Configurations](#Config) ### [](#throws-333)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3ConfigurationTimetracking)Select Time Tracking Implementation `` Selects a time tracking provider. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/configuration/timetracking endpoint. ### [](#parameters-336)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-334)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-335)For Configurations - [Configurations](#Config) ### [](#throws-334)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3ConfigurationTimetrackingOptions)Set Shared Time Tracking Configuration `` Sets the time tracking settings. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/configuration/timetracking/options endpoint. ### [](#parameters-337)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-335)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-336)For Configurations - [Configurations](#Config) ### [](#throws-335)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3CustomFieldOptionByFieldId)Update Custom Field Options `` This operation is deprecated and becomes unavailable on 8 May 2021. Use [Update custom field options (context)](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-custom-field-options/#api-rest-api-3-field-fieldid-context-contextid-option-put) instead. See [Deprecation of custom field options](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-removal-of-custom-field-options-operations/) for details. Updates the options on a custom select field. Where an updated option is in use on an issue, the value on the issue is also updated. Options that are not found are ignored. A maximum of 1000 options, including sub-options of **Select List (cascading)** fields, can be updated per request. The options are updated on the global context of the field. Note that this operation **only works for issue field select list options created in Jira or using operations from the \[Issue custom field options\](https://docs.mulesoft.com/jira-connector/latest/api-group-Issue-custom-field-options) resource**, it cannot be used with issue field select list options created by Connect apps. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/customField/{fieldId}/option endpoint. ### [](#parameters-338)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Id

Number

The ID of the custom field. Note: This is the numeric part of the of the field ID. For example, for a field with the ID customfield\_10075 use 10075.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-336)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-337)For Configurations - [Configurations](#Config) ### [](#throws-336)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3DashboardById)Update Dashboard `` Updates a dashboard, replacing all the dashboard details with those provided. **Permissions required:** None The dashboard to be updated must be owned by the user. This operation makes an HTTP PUT request to the /rest/api/3/dashboard/{id} endpoint. ### [](#parameters-339)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the dashboard to update.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-337)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-338)For Configurations - [Configurations](#Config) ### [](#throws-337)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3DashboardItemsPropertiesByDashboardIdItemIdPropertyKey)Set Dashboard Item Property `` Sets the value of a dashboard item property. Use this resource in apps to store custom data against a dashboard item. A dashboard item enables an app to add user-specific information to a user dashboard. Dashboard items are exposed to users as gadgets that users can add to their dashboards. For more information on how users do this, see [Adding and customizing gadgets](https://support.atlassian.com/jira-software-cloud/docs/add-and-customize-gadgets/). When an app creates a dashboard item, it registers a callback to receive the dashboard item ID. The callback fires whenever the item is rendered or, where the item is configurable, the user edits the item. The app then uses this resource to store the item’s content or configuration details. For more information on working with dashboard items, see [Building a dashboard item for a JIRA Connect add-on](https://developer.atlassian.com/server/jira/platform/guide-building-a-dashboard-item-for-a-jira-connect-add-on-33746254/) and the [Dashboard Item](https://developer.atlassian.com/cloud/jira/platform/modules/dashboard-item/) documentation. There is no resource to set or get dashboard items. The value of the request body must be a [valid](https://datatracker.ietf.org/doc/html/rfc4627), non-empty JSON blob. The maximum length is 32768 characters. This operation can be accessed anonymously. **Permissions required:** The user must be the owner of the dashboard. Note, users with the **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) are considered owners of the System dashboard. This operation makes an HTTP PUT request to the /rest/api/3/dashboard/{dashboardId}/items/{itemId}/properties/{propertyKey} endpoint. ### [](#parameters-340)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Dashboard Id

String

The ID of the dashboard.

Item Id

String

The ID of the dashboard item.

Property Key

String

The key of the dashboard item property. The maximum length is 255 characters.

Body

Binary

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-338)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-339)For Configurations - [Configurations](#Config) ### [](#throws-338)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3FieldByFieldId)Update Custom Field `` Updates a custom field. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/field/{fieldId} endpoint. ### [](#parameters-341)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Id

String

The ID of the custom field.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-339)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-340)For Configurations - [Configurations](#Config) ### [](#throws-339)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3FieldContextByFieldIdContextId)Update Custom Field Context `` Updates a [custom field context](https://support.atlassian.com/jira-cloud-administration/docs/configure-custom-field-context/). **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/field/{fieldId}/context/{contextId} endpoint. ### [](#parameters-342)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Id

String

The ID of the custom field.

Context Id

Number

The ID of the context.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-340)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-341)For Configurations - [Configurations](#Config) ### [](#throws-340)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3FieldContextDefaultValueByFieldId)Set Default Values `` Sets default for contexts of a custom field. Default are defined using these objects: - `CustomFieldContextDefaultValueSingleOption` (type `option.single`) for single choice select lists and radio buttons. - `CustomFieldContextDefaultValueMultipleOption` (type `option.multiple`) for multiple choice select lists and checkboxes. - `CustomFieldContextDefaultValueCascadingOption` (type `option.cascading`) for cascading select lists. Only one type of default object can be included in a request. To remove a default for a context, set the default parameter to `null`. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/field/{fieldId}/context/defaultValue endpoint. ### [](#parameters-343)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Id

String

The ID of the custom field.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-341)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-342)For Configurations - [Configurations](#Config) ### [](#throws-341)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3FieldContextIssuetypeByFieldIdContextId)Add Issue Types To Context `` Adds issue types to a custom field context, appending the issue types to the issue types list. A custom field context without any issue types applies to all issue types. Adding issue types to such a custom field context would result in it applying to only the listed issue types. If any of the issue types exists in the custom field context, the operation fails and no issue types are added. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/field/{fieldId}/context/{contextId}/issuetype endpoint. ### [](#parameters-344)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Id

String

The ID of the custom field.

Context Id

Number

The ID of the context.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-342)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-343)For Configurations - [Configurations](#Config) ### [](#throws-342)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3FieldContextOptionByFieldIdContextId)Update Custom Field Option `` Updates the options of a custom field. If any of the options are not found, no options are updated. Options where the values in the request match the current values aren’t updated and aren’t reported in the response. Note that this operation **only works for issue field select list options created in Jira or using operations from the \[Issue custom field options\](#api-group-Issue-custom-field-options) resource**, it cannot be used with issue field select list options created by Connect apps. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP PUT request to the /rest/api/3/field/{fieldId}/context/{contextId}/option endpoint. ### [](#parameters-345)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Id

String

The ID of the custom field.

Context Id

Number

The ID of the context.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-343)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-344)For Configurations - [Configurations](#Config) ### [](#throws-343)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3FieldContextOptionMoveByFieldIdContextId)Reorder Custom Field Options `` Changes the order of custom field options or cascading options in a context. This operation works for custom field options created in Jira or the operations from this resource. **To work with issue field select list options created for Connect apps use the \[Issue custom field options (apps)\](#api-group-issue-custom-field-options—apps-) operations.** **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/field/{fieldId}/context/{contextId}/option/move endpoint. ### [](#parameters-346)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Id

String

The ID of the custom field.

Context Id

Number

The ID of the context.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-344)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-345)For Configurations - [Configurations](#Config) ### [](#throws-344)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3FieldContextProjectByFieldIdContextId)Assign Projects To Custom Field Context `` Assigns a custom field context to projects. If any project in the request is assigned to any context of the custom field, the operation fails. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP PUT request to the /rest/api/3/field/{fieldId}/context/{contextId}/project endpoint. ### [](#parameters-347)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Id

String

The ID of the custom field.

Context Id

Number

The ID of the context.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-345)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-346)For Configurations - [Configurations](#Config) ### [](#throws-345)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3FieldOptionByFieldKeyOptionId)Update Issue Field Option `` Updates or creates an option for a select list issue field. This operation requires that the option ID is provided when creating an option, therefore, the option ID needs to be specified as a path and body parameter. The option ID provided in the path and body must be identical. Note that this operation **only works for issue field select list options added by Connect apps**, it cannot be used with issue field select list options created in Jira or using operations from the \[Issue custom field options\](https://docs.mulesoft.com/jira-connector/latest/api-group-Issue-custom-field-options) resource. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). Jira permissions are not required for the app providing the field. This operation makes an HTTP PUT request to the /rest/api/3/field/{fieldKey}/option/{optionId} endpoint. ### [](#parameters-348)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Field Key

String

The field key is specified in the following format: $(app-key)_\_$(field-key). For example, example-add-on\_\_example-issue-field. To determine the fieldKey value, do one of the following:

open the app’s plugin descriptor, then app-key is the key at the top and field-key is the key in the jiraIssueFields module. app-key can also be found in the app listing in the Atlassian Universal Plugin Manager.
run [Get fields](#api-rest-api-3-field-get) and in the field details the value is returned in key. For example, "key": "teams-add-on__team-issue-field"

Option Id

Number

The ID of the option to be updated.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-346)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-347)For Configurations - [Configurations](#Config) ### [](#throws-346)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3FieldconfigurationschemeProject)Assign Field Configuration Scheme To Project `` Assigns a field configuration scheme to a project. If the field configuration scheme ID is `null`, the operation assigns the default field configuration scheme. Field configuration schemes can only be assigned to classic projects. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/fieldconfigurationscheme/project endpoint. ### [](#parameters-349)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-347)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-348)For Configurations - [Configurations](#Config) ### [](#throws-347)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3FilterById)Update Filter `` Updates a filter. Use this operation to update a filter’s name, description, JQL, or sharing. **Permissions required:** Permission to access Jira, however the user must own the filter. This operation makes an HTTP PUT request to the /rest/api/3/filter/{id} endpoint. ### [](#parameters-350)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the filter to update.

expand

String

Use expand to include additional information about filter in the response. This parameter accepts a comma-separated list. Expand options include:

sharedUsers Returns the users that the filter is shared with. This includes users that can browse projects that the filter is shared with. If you don’t specify sharedUsers, then the sharedUsers object is returned but it doesn’t list any users. The list of users returned is limited to 1000, to access additional users append [start-index:end-index] to the expand request. For example, to access the next 1000 users, use ?expand=sharedUsers[1001:2000].
subscriptions Returns the users that are subscribed to the filter. If you don’t specify subscriptions, the subscriptions object is returned but it doesn’t list any subscriptions. The list of subscriptions returned is limited to 1000, to access additional subscriptions append [start-index:end-index] to the expand request. For example, to access the next 1000 subscriptions, use ?expand=subscriptions[1001:2000].

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-348)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-349)For Configurations - [Configurations](#Config) ### [](#throws-348)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3FilterColumnsById)Set Columns `` Sets the columns for a filter. Only navigable fields can be set as columns. Use \[Get fields\](#api-rest-api-3-field-get) to get the list fields in Jira. A navigable field has `navigable` set to `true`. The parameters for this resource are expressed as HTML form data. For example, in curl: `curl -X PUT -d columns=summary -d columns=description [https://your-domain.atlassian.net/rest/api/3/filter/10000/columns](https://your-domain.atlassian.net/rest/api/3/filter/10000/columns)` **Permissions required:** Permission to access Jira, however, columns are only set for: - filters owned by the user. - filters shared with a group that the user is a member of. - filters shared with a private project that the user has **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for. - filters shared with a public project. - filters shared with the public. This operation makes an HTTP PUT request to the /rest/api/3/filter/{id}/columns endpoint. ### [](#parameters-351)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the filter.

Body

Array of String

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-349)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-350)For Configurations - [Configurations](#Config) ### [](#throws-349)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3FilterDefaultShareScope)Set Default Share Scope `` Sets the default sharing for new filters and dashboards for a user. **Permissions required:** Permission to access Jira. This operation makes an HTTP PUT request to the /rest/api/3/filter/defaultShareScope endpoint. ### [](#parameters-352)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-350)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-351)For Configurations - [Configurations](#Config) ### [](#throws-350)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3FilterFavouriteById)Set Favourite For Filter `` Add a filter as a favorite for the user. **Permissions required:** Permission to access Jira, however, the user can only favorite: - filters owned by the user. - filters shared with a group that the user is a member of. - filters shared with a private project that the user has **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for. - filters shared with a public project. - filters shared with the public. This operation makes an HTTP PUT request to the /rest/api/3/filter/{id}/favourite endpoint. ### [](#parameters-353)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the filter.

expand

String

Use expand to include additional information about filter in the response. This parameter accepts a comma-separated list. Expand options include:

sharedUsers Returns the users that the filter is shared with. This includes users that can browse projects that the filter is shared with. If you don’t specify sharedUsers, then the sharedUsers object is returned but it doesn’t list any users. The list of users returned is limited to 1000, to access additional users append [start-index:end-index] to the expand request. For example, to access the next 1000 users, use ?expand=sharedUsers[1001:2000].
subscriptions Returns the users that are subscribed to the filter. If you don’t specify subscriptions, the subscriptions object is returned but it doesn’t list any subscriptions. The list of subscriptions returned is limited to 1000, to access additional subscriptions append [start-index:end-index] to the expand request. For example, to access the next 1000 subscriptions, use ?expand=subscriptions[1001:2000].

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-351)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-352)For Configurations - [Configurations](#Config) ### [](#throws-351)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3IssueAssigneeByIssueIdOrKey)Assign Issue `` Assigns an issue to a user. Use this operation when the calling user does not have the **Edit Issues** permission but has the **Assign issue** permission for the project that the issue is in. If `name` or `accountId` is set to: - `"-1"`, the issue is assigned to the default assignee for the project. - `null`, the issue is set to unassigned. This operation can be accessed anonymously. **Permissions required:** - **Browse Projects** and **Assign Issues** \[project permission\](https://docs.mulesoft.com/jira-connector/latest/[https://confluence.atlassian.com/x/yodKLg](https://confluence.atlassian.com/x/yodKLg)) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP PUT request to the /rest/api/3/issue/{issueIdOrKey}/assignee endpoint. ### [](#parameters-354)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue to be assigned.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-352)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-353)For Configurations - [Configurations](#Config) ### [](#throws-352)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3IssueByIssueIdOrKey)Edit Issue `` Edits an issue. A transition may be applied and issue properties updated as part of the edit. The edits to the issue’s fields are defined using `update` and `fields`. The fields that can be edited are determined using \[Get edit issue metadata\](#api-rest-api-3-issue-issueIdOrKey-editmeta-get). The parent field may be set by key or ID. For standard issue types, the parent may be removed by setting `update.parent.set.none` to **true**. Note that the `description`, `environment`, and any `textarea` type custom fields (multi-line text fields) take Atlassian Document Format content. Single line custom fields (`textfield`) accept a string and don’t handle Atlassian Document Format content. Connect app users with admin permissions (from user permissions and app scopes) can override the screen security configuration using `overrideScreenSecurity` and `overrideEditableFlag`. This operation can be accessed anonymously. **Permissions required:** - **Browse projects** and **Edit issues** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP PUT request to the /rest/api/3/issue/{issueIdOrKey} endpoint. ### [](#parameters-355)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Notify Users

Boolean

Whether a notification email about the issue update is sent to all watchers. To disable the notification, administer Jira or administer project permissions are required. If the user doesn’t have the necessary permission the request is ignored.

true

Override Screen Security

Boolean

Whether screen security should be overridden to enable hidden fields to be edited. Available to Connect app users with admin permissions.

false

Override Editable Flag

Boolean

Whether screen security should be overridden to enable uneditable fields to be edited. Available to Connect app users with admin permissions.

false

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-353)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-354)For Configurations - [Configurations](#Config) ### [](#throws-353)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3IssueCommentByIssueIdOrKeyId)Update Comment `` Updates a comment. This operation can be accessed anonymously. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue containing the comment is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. - **Edit all comments**\[project permission\](https://docs.mulesoft.com/jira-connector/latest/[https://confluence.atlassian.com/x/yodKLg](https://confluence.atlassian.com/x/yodKLg)) to update any comment or **Edit own comments** to update comment created by the user. - If the comment has visibility restrictions, the user belongs to the group or has the role visibility is restricted to. This operation makes an HTTP PUT request to the /rest/api/3/issue/{issueIdOrKey}/comment/{id} endpoint. ### [](#parameters-356)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

String

The ID of the comment.

expand

String

Use expand to include additional information about comments in the response. This parameter accepts renderedBody, which returns the comment body rendered in HTML.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-354)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-355)For Configurations - [Configurations](#Config) ### [](#throws-354)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3IssueLinkTypeByIssueLinkTypeId)Update Issue Link Type `` Updates an issue link type. To use this operation, the site must have [issue linking](https://confluence.atlassian.com/x/yoXKM) enabled. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/issueLinkType/{issueLinkTypeId} endpoint. ### [](#parameters-357)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Link Type Id

String

The ID of the issue link type.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-355)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-356)For Configurations - [Configurations](#Config) ### [](#throws-355)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3IssuePropertiesByIssueIdOrKeyPropertyKey)Set Issue Property `` Sets the value of an issue’s property. Use this resource to store custom data against an issue. The value of the request body must be a [valid](https://datatracker.ietf.org/doc/html/rfc4627), non-empty JSON blob. The maximum length is 32768 characters. This operation can be accessed anonymously. **Permissions required:** - **Browse projects** and **Edit issues** \[project permissions\](https://docs.mulesoft.com/jira-connector/latest/[https://confluence.atlassian.com/x/yodKLg](https://confluence.atlassian.com/x/yodKLg)) for the project containing the issue. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP PUT request to the /rest/api/3/issue/{issueIdOrKey}/properties/{propertyKey} endpoint. ### [](#parameters-358)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Property Key

String

The key of the issue property. The maximum length is 255 characters.

Body

Binary

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-356)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-357)For Configurations - [Configurations](#Config) ### [](#throws-356)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3IssuePropertiesByPropertyKey)Bulk Set Issue Property `` Sets a property value on multiple issues. The value set can be a constant or determined by a [Jira expression](https://developer.atlassian.com/cloud/jira/platform/jira-expressions/). Expressions must be computable with constant complexity when applied to a set of issues. Expressions must also comply with the [restrictions](https://developer.atlassian.com/cloud/jira/platform/jira-expressions/#restrictions) that apply to all Jira expressions. The issues to be updated can be specified by a filter. The filter identifies issues eligible for update using these criteria: - `entityIds` Only issues from this list are eligible. - `currentValue` Only issues with the property set to this value are eligible. - `hasProperty`: \* If **true**, only issues with the property are eligible. - If **false**, only issues without the property are eligible. If more than one criteria is specified, they are joined with the logical **AND**: only issues that satisfy all criteria are eligible. If an invalid combination of criteria is provided, an error is returned. For example, specifying a `currentValue` and `hasProperty` as **false** would not match any issues (because without the property the property cannot have a value). The filter is optional. Without the filter all the issues visible to the user and where the user has the EDIT\\\_ISSUES permission for the issue are considered eligible. This operation is: - transactional, either all eligible issues are updated or, when errors occur, none are updated. - \[asynchronous\](#async). Follow the `location` link in the response to determine the status of the task and use \[Get task\](#api-rest-api-3-task-taskId-get) to obtain subsequent updates. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for each project containing issues. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. - **Edit issues** [project permission](https://confluence.atlassian.com/x/yodKLg) for each issue. This operation makes an HTTP PUT request to the /rest/api/3/issue/properties/{propertyKey} endpoint. ### [](#parameters-359)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Property Key

String

The key of the property. The maximum length is 255 characters.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-357)Output

Type

String

Attributes Type

Http Response Attributes

### [](#for-configurations-358)For Configurations - [Configurations](#Config) ### [](#throws-357)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3IssueRemotelinkByIssueIdOrKeyLinkId)Update Remote Issue Link `` Updates a remote issue link for an issue. Note: Fields without values in the request are set to null. This operation requires \[issue linking to be active\](https://docs.mulesoft.com/jira-connector/latest/[https://confluence.atlassian.com/x/yoXKM](https://confluence.atlassian.com/x/yoXKM)). This operation can be accessed anonymously. **Permissions required:** - **Browse projects** and **Link issues** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. This operation makes an HTTP PUT request to the /rest/api/3/issue/{issueIdOrKey}/remotelink/{linkId} endpoint. ### [](#parameters-360)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Link Id

String

The ID of the remote issue link.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-358)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-359)For Configurations - [Configurations](#Config) ### [](#throws-358)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3IssueWorklogByIssueIdOrKeyId)Update Worklog `` Updates a worklog. Time tracking must be enabled in Jira, otherwise this operation returns an error. For more information, see [Configuring time tracking](https://confluence.atlassian.com/x/qoXKM). This operation can be accessed anonymously. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. - **Edit all worklogs** [project permission](https://confluence.atlassian.com/x/yodKLg) to update any worklog or **Edit own worklogs** to update worklogs created by the user. - If the worklog has visibility restrictions, belongs to the group or has the role visibility is restricted to. This operation makes an HTTP PUT request to the /rest/api/3/issue/{issueIdOrKey}/worklog/{id} endpoint. ### [](#parameters-361)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key the issue.

String

The ID of the worklog.

Notify Users

Boolean

Whether users watching the issue are notified by email.

true

Adjust Estimate

Enumeration, one of:

NEW
LEAVE
MANUAL
AUTO

Defines how to update the issue’s time estimate, the options are:

new Sets the estimate to a specific value, defined in newEstimate.
leave Leaves the estimate unchanged.
auto Updates the estimate by the difference between the original and updated value of timeSpent or timeSpentSeconds.

AUTO

New Estimate

String

The value to set as the issue’s remaining time estimate, as days (#d), hours (\#h), or minutes (\#m or \#). For example, 2d. Required when adjustEstimate is new.

expand

String

Use expand to include additional information about worklogs in the response. This parameter accepts properties, which returns worklog properties.

Override Editable Flag

Boolean

Whether the worklog should be added to the issue even if the issue is not editable. For example, because the issue is closed. Only connect app users with admin permissions can use this flag.

false

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-359)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-360)For Configurations - [Configurations](#Config) ### [](#throws-359)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3IssueWorklogPropertiesByIssueIdOrKeyWorklogIdPropertyKey)Set Worklog Property `` Sets the value of a worklog property. Use this operation to store custom data against the worklog. The value of the request body must be a \[valid\](https://docs.mulesoft.com/jira-connector/latest/[https://datatracker.ietf.org/doc/html/rfc4627](https://datatracker.ietf.org/doc/html/rfc4627)), non-empty JSON blob. The maximum length is 32768 characters. This operation can be accessed anonymously. **Permissions required:** - **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that the issue is in. - If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue. - **Edit all worklogs**\[ project permission\](https://docs.mulesoft.com/jira-connector/latest/[https://confluence.atlassian.com/x/yodKLg](https://confluence.atlassian.com/x/yodKLg)) to update any worklog or **Edit own worklogs** to update worklogs created by the user. - If the worklog has visibility restrictions, belongs to the group or has the role visibility is restricted to. This operation makes an HTTP PUT request to the /rest/api/3/issue/{issueIdOrKey}/worklog/{worklogId}/properties/{propertyKey} endpoint. ### [](#parameters-362)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Id Or Key

String

The ID or key of the issue.

Worklog Id

String

The ID of the worklog.

Property Key

String

The key of the issue property. The maximum length is 255 characters.

Body

Binary

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-360)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-361)For Configurations - [Configurations](#Config) ### [](#throws-360)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3IssuetypeById)Update Issue Type `` Updates the issue type. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/issuetype/{id} endpoint. ### [](#parameters-363)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the issue type.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-361)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-362)For Configurations - [Configurations](#Config) ### [](#throws-361)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3IssuetypePropertiesByIssueTypeIdPropertyKey)Set Issue Type Property `` Creates or updates the value of the [issue type property](https://developer.atlassian.com/cloud/jira/platform/storing-data-with-entity-properties/). Use this resource to store and update data against an issue type. The value of the request body must be a [valid](https://datatracker.ietf.org/doc/html/rfc4627), non-empty JSON blob. The maximum length is 32768 characters. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/issuetype/{issueTypeId}/properties/{propertyKey} endpoint. ### [](#parameters-364)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Type Id

String

The ID of the issue type.

Property Key

String

The key of the issue type property. The maximum length is 255 characters.

Body

Binary

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-362)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-363)For Configurations - [Configurations](#Config) ### [](#throws-362)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3IssuetypeschemeByIssueTypeSchemeId)Update Issue Type Scheme `` Updates an issue type scheme. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/issuetypescheme/{issueTypeSchemeId} endpoint. ### [](#parameters-365)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Type Scheme Id

Number

The ID of the issue type scheme.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-363)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-364)For Configurations - [Configurations](#Config) ### [](#throws-363)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3IssuetypeschemeIssuetypeByIssueTypeSchemeId)Add Issue Types To Issue Type Scheme `` Adds issue types to an issue type scheme. The added issue types are appended to the issue types list. If any of the issue types exist in the issue type scheme, the operation fails and no issue types are added. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/issuetypescheme/{issueTypeSchemeId}/issuetype endpoint. ### [](#parameters-366)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Type Scheme Id

Number

The ID of the issue type scheme.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-364)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-365)For Configurations - [Configurations](#Config) ### [](#throws-364)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3IssuetypeschemeIssuetypeMoveByIssueTypeSchemeId)Reorder Issue Types In Issue Type Scheme `` Changes the order of issue types in an issue type scheme. The request body parameters must meet the following requirements: - all of the issue types must belong to the issue type scheme. - either `after` or `position` must be provided. - the issue type in `after` must not be in the issue type list. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/issuetypescheme/{issueTypeSchemeId}/issuetype/move endpoint. ### [](#parameters-367)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Type Scheme Id

Number

The ID of the issue type scheme.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-365)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-366)For Configurations - [Configurations](#Config) ### [](#throws-365)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3IssuetypeschemeProject)Assign Issue Type Scheme To Project `` Assigns an issue type scheme to a project. If any issues in the project are assigned issue types not present in the new scheme, the operation will fail. To complete the assignment those issues must be updated to use issue types in the new scheme. Issue type schemes can only be assigned to classic projects. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/issuetypescheme/project endpoint. ### [](#parameters-368)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-366)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-367)For Configurations - [Configurations](#Config) ### [](#throws-366)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3IssuetypescreenschemeByIssueTypeScreenSchemeId)Update Issue Type Screen Scheme `` Updates an issue type screen scheme. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/issuetypescreenscheme/{issueTypeScreenSchemeId} endpoint. ### [](#parameters-369)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Type Screen Scheme Id

String

The ID of the issue type screen scheme.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-367)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-368)For Configurations - [Configurations](#Config) ### [](#throws-367)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3IssuetypescreenschemeMappingByIssueTypeScreenSchemeId)Append Mappings For Issue Type Screen Scheme `` Appends issue type to screen scheme mappings to an issue type screen scheme. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/issuetypescreenscheme/{issueTypeScreenSchemeId}/mapping endpoint. ### [](#parameters-370)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Type Screen Scheme Id

String

The ID of the issue type screen scheme.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-368)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-369)For Configurations - [Configurations](#Config) ### [](#throws-368)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3IssuetypescreenschemeMappingDefaultByIssueTypeScreenSchemeId)Update Default Screen Scheme `` Updates the default screen scheme of an issue type screen scheme. The default screen scheme is used for all unmapped issue types. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/issuetypescreenscheme/{issueTypeScreenSchemeId}/mapping/default endpoint. ### [](#parameters-371)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Issue Type Screen Scheme Id

String

The ID of the issue type screen scheme.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-369)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-370)For Configurations - [Configurations](#Config) ### [](#throws-369)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3IssuetypescreenschemeProject)Assign Issue Type Screen Scheme To Project `` Assigns an issue type screen scheme to a project. Issue type screen schemes can only be assigned to classic projects. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP PUT request to the /rest/api/3/issuetypescreenscheme/project endpoint. ### [](#parameters-372)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-370)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-371)For Configurations - [Configurations](#Config) ### [](#throws-370)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3Mypreferences)Set Preference `` Creates a preference for the user or updates a preference’s value by sending a plain text string. For example, `false`. An arbitrary preference can be created with the value containing up to 255 characters. In addition, the following keys define system preferences that can be set or created: - **user.notifications.mimetype** The MIME type used in notifications sent to the user. Defaults to `html`. - **user.notify.own.changes** Whether the user gets notified of their own changes. Defaults to `false`. - **user.default.share.private** Whether new \[ filters\](https://docs.mulesoft.com/jira-connector/latest/[https://support.atlassian.com/jira-software-cloud/docs/save-your-search-as-a-filter/](https://support.atlassian.com/jira-software-cloud/docs/save-your-search-as-a-filter/)) are set to private. Defaults to `true`. - **user.keyboard.shortcuts.disabled** Whether keyboard shortcuts are disabled. Defaults to `false`. - **user.autowatch.disabled** Whether the user automatically watches issues they create or add a comment to. By default, not set: the user takes the instance autowatch setting. Note that these keys are deprecated: - **jira.user.locale** The locale of the user. By default, not set. The user takes the instance locale. - **jira.user.timezone** The time zone of the user. By default, not set. The user takes the instance timezone. Use [Update a user profile](https://developer.atlassian.com/cloud/admin/user-management/rest/#api-users-account-id-manage-profile-patch) from the user management REST API to manage timezone and locale instead. **Permissions required:** Permission to access Jira. This operation makes an HTTP PUT request to the /rest/api/3/mypreferences endpoint. ### [](#parameters-373)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

key

String

The key of the preference. The maximum length is 255 characters.

Body

String

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-371)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-372)For Configurations - [Configurations](#Config) ### [](#throws-371)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3PermissionschemeBySchemeId)Update Permission Scheme `` Updates a permission scheme. Below are some important things to note when using this resource: - If a permissions list is present in the request, then it is set in the permission scheme, overwriting **all existing** grants. - If you want to update only the name and description, then do not send a permissions list in the request. - Sending an empty list will remove all permission grants from the permission scheme. If you want to add or delete a permission grant instead of updating the whole list, see \[Create permission grant\](https://docs.mulesoft.com/jira-connector/latest/api-rest-api-3-permissionscheme-schemeId-permission-post) or \[Delete permission scheme entity\](https://docs.mulesoft.com/jira-connector/latest/api-rest-api-3-permissionscheme-schemeId-permission-permissionId-delete). See \[About permission schemes and grants\](https://docs.mulesoft.com/jira-connector/latest/about-permission-schemes) for more details. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/permissionscheme/{schemeId} endpoint. ### [](#parameters-374)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Scheme Id

Number

The ID of the permission scheme to update.

expand

String

all Returns all expandable information.
field Returns information about the custom field granted the permission.
group Returns information about the group that is granted the permission.
permissions Returns all permission grants for each permission scheme.
projectRole Returns information about the project role granted the permission.
user Returns information about the user who is granted the permission.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-372)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-373)For Configurations - [Configurations](#Config) ### [](#throws-372)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3ProjectAvatarByProjectIdOrKey)Update Project Avatar `` Sets the avatar displayed for a project. Use \[Load project avatar\](#api-rest-api-3-project-projectIdOrKey-avatar2-post) to store avatars against the project, before using this operation to set the displayed avatar. **Permissions required:** **Administer projects** [project permission](https://confluence.atlassian.com/x/yodKLg). This operation makes an HTTP PUT request to the /rest/api/3/project/{projectIdOrKey}/avatar endpoint. ### [](#parameters-375)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The ID or (case-sensitive) key of the project.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-373)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-374)For Configurations - [Configurations](#Config) ### [](#throws-373)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3ProjectByProjectIdOrKey)Update Project `` Updates the \[project details\](https://docs.mulesoft.com/jira-connector/latest/[https://support.atlassian.com/jira-software-cloud/docs/edit-a-projects-details/](https://support.atlassian.com/jira-software-cloud/docs/edit-a-projects-details/)) of a project. All parameters are optional in the body of the request. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/project/{projectIdOrKey} endpoint. ### [](#parameters-376)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or project key (case sensitive).

expand

String

description The project description.
issueTypes The issue types associated with the project.
lead The project lead. * projectKeys All project keys associated with the project.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-374)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-375)For Configurations - [Configurations](#Config) ### [](#throws-374)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3ProjectCategoryById)Update Project Category `` Updates a project category. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/projectCategory/{id} endpoint. ### [](#parameters-377)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-375)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-376)For Configurations - [Configurations](#Config) ### [](#throws-375)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3ProjectEmailByProjectId)Update Project Email `` Sets the \[project’s sender email address\](https://docs.mulesoft.com/jira-connector/latest/[https://confluence.atlassian.com/x/dolKLg](https://confluence.atlassian.com/x/dolKLg)). If `emailAddress` is an empty string, the default email address is restored. **Permissions required:** **Browse projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project. This operation makes an HTTP PUT request to the /rest/api/3/project/{projectId}/email endpoint. ### [](#parameters-378)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id

Number

The project ID.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-376)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-377)For Configurations - [Configurations](#Config) ### [](#throws-376)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3ProjectPermissionschemeByProjectKeyOrId)Assign Permission Scheme `` Assigns a permission scheme with a project. See [Managing project permissions](https://confluence.atlassian.com/x/yodKLg) for more information about permission schemes. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/project/{projectKeyOrId}/permissionscheme endpoint. ### [](#parameters-379)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Key Or Id

String

The project ID or project key (case sensitive).

expand

String

Use expand to include additional information in the response. This parameter accepts a comma-separated list. Note that permissions are included when you specify any value. Expand options include:

all Returns all expandable information.
field Returns information about the custom field granted the permission.
group Returns information about the group that is granted the permission.
permissions Returns all permission grants for each permission scheme.
projectRole Returns information about the project role granted the permission.
user Returns information about the user who is granted the permission.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-377)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-378)For Configurations - [Configurations](#Config) ### [](#throws-377)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3ProjectPropertiesByProjectIdOrKeyPropertyKey)Set Project Property `` Sets the value of the [project property](https://developer.atlassian.com/cloud/jira/platform/storing-data-with-entity-properties/). You can use project properties to store custom data against the project. The value of the request body must be a [valid](https://datatracker.ietf.org/doc/html/rfc4627), non-empty JSON blob. The maximum length is 32768 characters. This operation can be accessed anonymously. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) or **Administer Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project in which the property is created. This operation makes an HTTP PUT request to the /rest/api/3/project/{projectIdOrKey}/properties/{propertyKey} endpoint. ### [](#parameters-380)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or project key (case sensitive).

Property Key

String

The key of the project property. The maximum length is 255 characters.

Body

Binary

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-378)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-379)For Configurations - [Configurations](#Config) ### [](#throws-378)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3ProjectRoleByProjectIdOrKeyId)Set Actors `` Sets the actors for a project role for a project, replacing all existing actors. To add actors to the project without overwriting the existing list, use \[Add actors to project role\](#api-rest-api-3-project-projectIdOrKey-role-id-post). **Permissions required:** **Administer Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project or **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP PUT request to the /rest/api/3/project/{projectIdOrKey}/role/{id} endpoint. ### [](#parameters-381)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Project Id Or Key

String

The project ID or project key (case sensitive).

Number

The ID of the project role. Use [Get all project roles](#api-rest-api-3-role-get) to get a list of project role IDs.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-379)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-380)For Configurations - [Configurations](#Config) ### [](#throws-379)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3RoleById)Fully Update Project Role `` Updates the project role’s name and description. You must include both a name and a description in the request. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/role/{id} endpoint. ### [](#parameters-382)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the project role. Use [Get all project roles](#api-rest-api-3-role-get) to get a list of project role IDs.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-380)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-381)For Configurations - [Configurations](#Config) ### [](#throws-380)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3ScreensByScreenId)Update Screen `` Updates a screen. Only screens used in classic projects can be updated. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/screens/{screenId} endpoint. ### [](#parameters-383)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Screen Id

Number

The ID of the screen.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-381)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-382)For Configurations - [Configurations](#Config) ### [](#throws-381)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3ScreensTabsByScreenIdTabId)Rename Screen Tab `` Updates the name of a screen tab. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/screens/{screenId}/tabs/{tabId} endpoint. ### [](#parameters-384)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Screen Id

Number

The ID of the screen.

Tab Id

Number

The ID of the screen tab.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-382)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-383)For Configurations - [Configurations](#Config) ### [](#throws-382)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3ScreenschemeByScreenSchemeId)Update Screen Scheme `` Updates a screen scheme. Only screen schemes used in classic projects can be updated. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/screenscheme/{screenSchemeId} endpoint. ### [](#parameters-385)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Screen Scheme Id

String

The ID of the screen scheme.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-383)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-384)For Configurations - [Configurations](#Config) ### [](#throws-383)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3SettingsColumns)Set Issue Navigator Default Columns `` Sets the default issue navigator columns. The `columns` parameter accepts a navigable field value and is expressed as HTML form data. To specify multiple columns, pass multiple `columns` parameters. For example, in curl: `curl -X PUT -d columns=summary -d columns=description [https://your-domain.atlassian.net/rest/api/3/settings/columns](https://your-domain.atlassian.net/rest/api/3/settings/columns)` If no column details are sent, then all default columns are removed. A navigable field is one that can be used as a column on the issue navigator. Find details of navigable issue columns using \[Get fields\](#api-rest-api-3-field-get). **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/settings/columns endpoint. ### [](#parameters-386)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Array of String

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-384)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-385)For Configurations - [Configurations](#Config) ### [](#throws-384)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3UserColumns)Set User Columns `` Sets the default [issue table columns](https://confluence.atlassian.com/x/XYdKLg) for the user. If an account ID is not passed, the calling user’s default columns are set. If no column details are sent, then all default columns are removed. The parameters for this resource are expressed as HTML form data. For example, in curl: `curl -X PUT -d columns=summary -d columns=description [https://your-domain.atlassian.net/rest/api/3/user/columns?accountId=5b10ac8d82e05b22cc7d4ef5'](https://your-domain.atlassian.net/rest/api/3/user/columns?accountId=5b10ac8d82e05b22cc7d4ef5')` **Permissions required:** - **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg), to set the columns on any user. - Permission to access Jira, to set the calling user’s columns. This operation makes an HTTP PUT request to the /rest/api/3/user/columns endpoint. ### [](#parameters-387)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Account Id

String

The account ID of the user, which uniquely identifies the user across all Atlassian products. For example, 5b10ac8d82e05b22cc7d4ef5.

Body

Array of String

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-385)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-386)For Configurations - [Configurations](#Config) ### [](#throws-385)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3UserPropertiesByPropertyKey)Set User Property `` Sets the value of a user’s property. Use this resource to store custom data against a user. Note: This operation does not access the [user properties](https://support.atlassian.com/user-management/docs/update-roles-and-properties-for-jira-users/) created and maintained in Jira. **Permissions required:** - **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg), to set a property on any user. - Access to Jira, to set a property on the calling user’s record. This operation makes an HTTP PUT request to the /rest/api/3/user/properties/{propertyKey} endpoint. ### [](#parameters-388)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Property Key

String

The key of the user’s property. The maximum length is 255 characters.

Account Id

String

The account ID of the user, which uniquely identifies the user across all Atlassian products. For example, 5b10ac8d82e05b22cc7d4ef5.

User Key

String

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

username

String

This parameter is no longer available and will be removed from the documentation soon. See the deprecation notice for details.

Body

Binary

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-386)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-387)For Configurations - [Configurations](#Config) ### [](#throws-386)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3VersionById)Update Version `` Updates a project version. This operation can be accessed anonymously. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) or **Administer Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that contains the version. This operation makes an HTTP PUT request to the /rest/api/3/version/{id} endpoint. ### [](#parameters-389)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the version.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-387)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-388)For Configurations - [Configurations](#Config) ### [](#throws-387)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3VersionMergetoByIdMoveIssuesTo)Merge Versions `` Merges two project versions. The merge is completed by deleting the version specified in `id` and replacing any occurrences of its ID in `fixVersion` with the version ID specified in `moveIssuesTo`. Consider using \[ Delete and replace version\](#api-rest-api-3-version-id-removeAndSwap-post) instead. This resource supports swapping version values in `fixVersion`, `affectedVersion`, and custom fields. This operation can be accessed anonymously. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) or **Administer Projects** [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that contains the version. This operation makes an HTTP PUT request to the /rest/api/3/version/{id}/mergeto/{moveIssuesTo} endpoint. ### [](#parameters-390)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

String

The ID of the version to delete.

Move Issues To

String

The ID of the version to merge into.

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

#[null]

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-388)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-389)For Configurations - [Configurations](#Config) ### [](#throws-388)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3WebhookRefresh)Refresh Webhooks `` Webhooks registered through the REST API expire after 30 days. Call this resource periodically to keep them alive. Unrecognized webhook IDs (nonexistent or belonging to other apps) are ignored. **Permissions required:** Only [Connect apps](https://developer.atlassian.com/cloud/jira/platform/index/) can use this operation. This operation makes an HTTP PUT request to the /rest/api/3/webhook/refresh endpoint. ### [](#parameters-391)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-389)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-390)For Configurations - [Configurations](#Config) ### [](#throws-389)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3WorkflowRuleConfig)Update Workflow Transition Rule Configurations `` Updates configuration of workflow transition rules. The following rule types are supported: - [post functions](https://developer.atlassian.com/cloud/jira/platform/modules/workflow-post-function/) - [conditions](https://developer.atlassian.com/cloud/jira/platform/modules/workflow-condition/) - [validators](https://developer.atlassian.com/cloud/jira/platform/modules/workflow-validator/) Only rules created by the calling Connect app can be updated. **Permissions required:** Only Connect apps can use this operation. This operation makes an HTTP PUT request to the /rest/api/3/workflow/rule/config endpoint. ### [](#parameters-392)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-390)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-391)For Configurations - [Configurations](#Config) ### [](#throws-390)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3WorkflowTransitionsPropertiesByTransitionId)Update Workflow Transition Property `` Updates a workflow transition by changing the property value. Trying to update a property that does not exist results in a new property being added to the transition. Transition properties are used to change the behavior of a transition. For more information, see [Transition properties](https://confluence.atlassian.com/x/zIhKLg#Advancedworkflowconfiguration-transitionproperties) and [Workflow properties](https://confluence.atlassian.com/x/JYlKLg). **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/workflow/transitions/{transitionId}/properties endpoint. ### [](#parameters-393)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Transition Id

Number

The ID of the transition. To get the ID, view the workflow in text mode in the Jira admin settings. The ID is shown next to the transition.

key

String

The key of the property being updated, also known as the name of the property. Set this to the same value as the key defined in the request body.

Workflow Name

String

The name of the workflow that the transition belongs to.

Workflow Mode

Enumeration, one of:

LIVE
DRAFT

The workflow status. Set to live for inactive workflows or draft for draft workflows. Active workflows cannot be edited.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-391)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-392)For Configurations - [Configurations](#Config) ### [](#throws-391)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3WorkflowschemeById)Update Workflow Scheme `` Updates a workflow scheme, including the name, default workflow, issue type to project mappings, and more. If the workflow scheme is active (that is, being used by at least one project), then a draft workflow scheme is created or updated instead, provided that `updateDraftIfNeeded` is set to `true`. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/workflowscheme/{id} endpoint. ### [](#parameters-394)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the workflow scheme. Find this ID by editing the desired workflow scheme in Jira. The ID is shown in the URL as schemeId. For example, schemeId=10301.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-392)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-393)For Configurations - [Configurations](#Config) ### [](#throws-392)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3WorkflowschemeDefaultById)Update Default Workflow `` Sets the default workflow for a workflow scheme. Note that active workflow schemes cannot be edited. If the workflow scheme is active, set `updateDraftIfNeeded` to `true` in the request object and a draft workflow scheme is created or updated with the new default workflow. The draft workflow scheme can be published in Jira. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/workflowscheme/{id}/default endpoint. ### [](#parameters-395)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the workflow scheme.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-393)Output

Type

Any

Attributes Type

Http Response Attributes

### [](#for-configurations-394)For Configurations - [Configurations](#Config) ### [](#throws-393)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3WorkflowschemeDraftById)Update Workflow Scheme Draft `` Updates a draft workflow scheme. If a draft workflow scheme does not exist for the active workflow scheme, then a draft is created. Note that an active workflow scheme can only have one draft workflow scheme. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/workflowscheme/{id}/draft endpoint. ### [](#parameters-396)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the active workflow scheme that the draft was created from.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-394)Output

Type

Attributes Type

### [](#for-configurations-395)For Configurations - [Configurations](#Config) ### [](#throws-394)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3WorkflowschemeDraftDefaultById)Update Draft Default Workflow `` Sets the default workflow for a workflow scheme’s draft. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/workflowscheme/{id}/draft/default endpoint. ### [](#parameters-397)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the workflow scheme that the draft belongs to.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-395)Output

Type

Attributes Type

### [](#for-configurations-396)For Configurations - [Configurations](#Config) ### [](#throws-395)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3WorkflowschemeDraftIssuetypeByIdIssueType)Set Workflow Scheme Draft Issue Type `` Sets the workflow for an issue type in a workflow scheme’s draft. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg). This operation makes an HTTP PUT request to the /rest/api/3/workflowscheme/{id}/draft/issuetype/{issueType} endpoint. ### [](#parameters-398)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

Number

The ID of the workflow scheme that the draft belongs to.

Issue Type

String

The ID of the issue type.

Body

Any

the content to use

#[payload]

Config Ref

ConfigurationProvider

Name of the configuration to use to execute this component.

Streaming Strategy

Repeatable In Memory Stream
Repeatable File Store Stream
non-repeatable-stream

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Object

Custom Headers

Object

Response Timeout

Number

The timeout for request to the remote service.

Response Timeout Unit

Enumeration, one of:

NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

Time unit that qualifies the Response Timeout.

Streaming Type

Enumeration, one of:

AUTO
ALWAYS
NEVER

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

String

Name of the variable that stores the operation’s output.

Target Value

String

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

Reconnect
Reconnect Forever

A retry strategy in case of connectivity errors

### [](#output-396)Output

### [](#for-configurations-397)For Configurations - [Configurations](#Config) ### [](#throws-396)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3WorkflowschemeDraftWorkflowById)Update Draft Workflow Mapping `` Sets the issue types for a workflow in a workflow scheme’s draft. The workflow can also be set as the default workflow for the draft workflow scheme. Unmapped issues types are mapped to the default workflow. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/workflowscheme/{id}/draft/workflow endpoint. ### [](#parameters-399)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

The ID of the workflow scheme that the draft belongs to.

Workflow Name

The name of the workflow.

Body

the content to use

#[payload]

Config Ref

Name of the configuration to use to execute this component.

Streaming Strategy

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Custom Headers

Response Timeout

The timeout for request to the remote service.

Response Timeout Unit

Time unit that qualifies the Response Timeout.

Streaming Type

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

Name of the variable that stores the operation’s output.

Target Value

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors

### [](#output-397)Output

### [](#for-configurations-398)For Configurations - [Configurations](#Config) ### [](#throws-397)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3WorkflowschemeIssuetypeByIdIssueType)Set Workflow Scheme Issue Type `` Sets the workflow for an issue type in a workflow scheme. Note that active workflow schemes cannot be edited. If the workflow scheme is active, set `updateDraftIfNeeded` to `true` in the request body and a draft workflow scheme is created or updated with the new issue type-workflow mapping. The draft workflow scheme can be published in Jira. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/workflowscheme/{id}/issuetype/{issueType} endpoint. ### [](#parameters-400)Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

The ID of the workflow scheme.

Issue Type

The ID of the issue type.

Body

the content to use

#[payload]

Config Ref

Name of the configuration to use to execute this component.

Streaming Strategy

Configures how Mule processes streams. Repeatable streams are the default behavior.

Custom Query Parameters

Custom Headers

Response Timeout

The timeout for request to the remote service.

Response Timeout Unit

Time unit that qualifies the Response Timeout.

Streaming Type

Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.

Target Variable

Name of the variable that stores the operation’s output.

Target Value

Expression that evaluates the operation’s output. The expression outcome is stored in the target variable.

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors

### [](#output-398)Output

### [](#for-configurations-399)For Configurations - [Configurations](#Config) ### [](#throws-398)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3WorkflowschemeProject)Associate Scheme With Project `` Assigns a workflow scheme to a project. This operation is performed only when there are no issues in the project. Workflow schemes can only be assigned to classic projects. **Permissions required:** **Administer Jira** [global permission](https://confluence.atlassian.com/x/x4dKLg) This operation makes an HTTP PUT request to the /rest/api/3/workflowscheme/project endpoint. ### [](#parameters-401)Parameters

Name Type Description Default Value Required

### [](#output-399)Output

### [](#for-configurations-400)For Configurations - [Configurations](#Config) ### [](#throws-399)Throws - JIRA:BAD\_REQUEST - JIRA:CLIENT\_ERROR - JIRA:CONNECTIVITY - JIRA:INTERNAL\_SERVER\_ERROR - JIRA:NOT\_ACCEPTABLE - JIRA:NOT\_FOUND - JIRA:RETRY\_EXHAUSTED - JIRA:SERVER\_ERROR - JIRA:SERVICE\_UNAVAILABLE - JIRA:TIMEOUT - JIRA:TOO\_MANY\_REQUESTS - JIRA:UNAUTHORIZED - JIRA:UNSUPPORTED\_MEDIA\_TYPE ## [](#UpdateRestApi3WorkflowschemeWorkflowById)Update Workflow Mapping `