Jira Connector 1.2 Reference | MuleSoft Documentation
# Jira Connector 1.2 Reference
Anypoint Connector for Jira (Jira Connector) enables you to interface with the Jira platform without having to interact with the Jira API directly.
## Configurations
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
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 | Timeout for the request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines whether to send the request using streaming. Setting the value to AUTO automatically defines the best strategy based on the request content.  
The identifier of this element and used in other components to reference it.  
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.  
## Connection Types
Jira Connector does not support authentication via personal access tokens (PATs).   
---  
### Basic Auth Connection Provider
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Default Headers |  Array of Default Header  
Query Parameters |  Array of Default Query Param  
Connection Timeout | Timeout for establishing connections to the remote service.  
Connection Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Connection Timeout**.  
Use Persistent Connections | If false, each connection is closed after the first request is completed.  
Max Connections | Maximum number of outbound connections to keep open at the same time.  
Connection Idle Timeout | 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

| Time unit that qualifies the **Connection Idle Timeout**.  
Proxy Config | Reusable configuration element for outbound connections through a proxy.  
Stream Response | Whether or not to stream received responses.  
Response Buffer Size | The space in bytes for the buffer where the HTTP response will be stored.  
Username | The username used to authenticate the requests.  
API Token | API token used to authenticate the requests.  
Base Uri | Base URI for the parameter. Each instance or tenant gets its own base URI.  
Protocol |  Enumeration, one of: | Protocol to use for communication. Valid values are HTTP and HTTPS.  
TLS Configuration  
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.  
### 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 or Configuring OAuth 2.0 for Connectors on CloudHub.
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Default Headers |  Array of Default Header  
Query Parameters |  Array of Default Query Param  
Connection Timeout | Timeout for establishing connections to the remote service.  
Connection Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Connection Timeout**.  
Use Persistent Connections | If false, each connection is closed after the first request is completed.  
Max Connections | Maximum number of outbound connections that will be kept open concurrently.  
Connection Idle Timeout | 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
| A time unit which qualifies the connection Idle Timeout  
Proxy Config | Reusable configuration element for outbound connections through a proxy  
Stream Response | Whether or not received responses should be streamed  
Response Buffer Size | The space in bytes for the buffer where the HTTP response will be stored.  
Base Uri | Parameter base URI, each instance/tenant gets its own | `https://api.atlassian.com/ex/jira`  
Audience | Base url of the Atlassian API | api.atlassian.com  
Set to consent so that the screen prompting the user to grant access will display.  
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 | 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: | Protocol to use for communication. Valid values are HTTP and HTTPS  
TLS Configuration  
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 | OAuth consumer key as registered with the service provider.  
Consumer Secret | OAuth consumer secret as registered with the service provider.  
Authorization Url | Service provider’s authorization endpoint URL. | https://auth.atlassian.com/authorize  
Access Token Url | The service provider’s accessToken endpoint URL | `https://auth.atlassian.com/oauth/token`  
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 | The resource owner ID each component should use if the resource owner ID is not otherwise referenced.  
Name of a flow to execute immediately before starting the OAuth dance.  
Name of a flow to execute immediately after an access token is received.  
Listener Config | A reference to a <http:listener-config /> to use to create the listener that will receive the access token callback endpoint.  
Callback Path | Path of the access token callback endpoint.  
Authorize Path | Path of the local HTTP endpoint that triggers the OAuth dance.  
External Callback Url | 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 | 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
  * Get Comments By Ids
  *   * Create Custom Field Options
  *   *   * Analyse Expression
  * Evaluate Jira Expression
  * Create Custom Field
  * Create Custom Field Context
  * Remove Issue Types From Context
  * Get Custom Field Contexts For Projects And Issue Types
  * Create Custom Field Option
  * Remove Custom Field Context From Projects
  * Create Issue Field Option
  *   * Add Share Permission
  *   * Add User To Group
  *   *   *   *   *   * Create Issue Link Type
  * Bulk Set Issues Properties
  * Create Or Update Remote Issue Link
  *   *   *   * Create Issue Type
  * Create Issue Type Avatar
  * Create Issue Type Scheme
  * Create Issue Type Screen Scheme
  * Remove Mappings From Issue Type Screen Scheme
  *   * Parse Jql Queries
  *   * Get Bulk Permissions
  * Get Permitted Projects
  * Create Permission Scheme
  * Create Permission Grant
  *   *   * Create Project Avatar
  * Create Project Category
  * Delete Project Asynchronously
  *   * Create Project Role
  * Add Project Role Actors To Role
  * Partial Update Project Role
  *   * Add Field To Default Screen
  *   * Add Screen Tab Field
  * Move Screen Tab Field
  *   * Create Screen Scheme
  * Search For Issues Using Jql Post
  *   *   *   *   *   * Delete And Replace Version
  * Register Dynamic Webhooks
  * Create Workflow Transition Property
  * Create Workflow Scheme
  * Create Workflow Scheme Draft From Parent
  * Get Worklogs For Ids
  * Dynamic Modules Resource register Modules post
  * Remove Attachment
  * Delete Comment Property
  *   *   * Delete Dashboard Item Property
  * Delete Custom Field Context
  * Delete Custom Field Option
  * Delete Issue Field Option
  * Replace Issue Field Option
  *   *   * Delete Favourite For Filter
  * Delete Share Permission
  *   * Remove User From Group
  *   *   *   * Delete Issue Link Type
  * Delete Issue Property
  * Bulk Delete Issue Property
  * Delete Remote Issue Link By Global Id
  * Delete Remote Issue Link By Id
  *   *   *   * Delete Worklog Property
  * Delete Issue Type
  * Delete Issue Type Property
  * Delete Issue Type Scheme
  * Remove Issue Type From Issue Type Scheme
  * Delete Issue Type Screen Scheme
  * Remove Preference
  * Delete Permission Scheme
  * Delete Permission Scheme Entity
  * Delete Project Avatar
  *   * Remove Project Category
  * Delete Project Property
  *   * Delete Project Role Actors From Role
  * Delete Project Role
  *   *   * Remove Screen Tab Field
  * Delete Screen Scheme
  *   *   * Reset User Columns
  * Delete User Property
  * Delete Webhook By Id
  * Delete Workflow Transition Property
  * Delete Workflow Scheme
  * Delete Default Workflow
  * Delete Workflow Scheme Draft
  * Delete Draft Default Workflow
  * Delete Workflow Scheme Draft Issue Type
  * Delete Draft Workflow Mapping
  * Delete Workflow Scheme Issue Type
  * Delete Workflow Mapping
  * Addon Properties Resource delete Addon Property delete
  * Dynamic Modules Resource remove Modules delete
  * Get Application Property
  * Get Advanced Settings
  * Get All Application Roles
  * Get Application Role
  *   * Expand Attachment For Humans
  * Expand Attachment For Machines
  * Get Attachment Meta
  * Get Audit Records
  * Get All System Avatars
  * Get Comment Property Keys
  *   *   * Get Component Related Issues
  * Get Configuration
  * Get Selected Time Tracking Implementation
  * Get Available Time Tracking Implementations
  * Get Shared Time Tracking Configuration
  * Get Options For Field
  * Get All Dashboards
  *   * Get Dashboard Item Property Keys
  * Get Dashboard Item Property
  * Get Dashboards Paginated
  *   * Get Contexts For Field
  *   * Get Issue Type Mappings For Contexts
  * Get Options For Context
  * Get Project Context Mapping
  * Get All Issue Field Options
  * Get Issue Field Option
  * Get Selectable Issue Field Options
  * Get Visible Issue Field Options
  * Get Screens For Field
  * Get Fields Paginated
  * Get All Field Configurations
  * Get Field Configuration Items
  * Get All Field Configuration Schemes
  * Get Field Configuration Scheme Mappings
  * Get Field Configuration Scheme Project Mapping
  *   *   * Get Default Share Scope
  * Get Favourite Filters
  *   * Get Share Permissions
  * Get Share Permission
  * Get Filters Paginated
  *   * Get Users From Group
  *   * Find Users And Groups
  *   *   *   * Get Create Issue Meta
  * Get Edit Issue Meta
  *   * Get Issue Link Types
  *   * Get Issue Picker Resource
  * Get Issue Property Keys
  *   * Get Remote Issue Links
  * Get Remote Issue Link By Id
  *   *   *   *   * Get Worklog Property Keys
  *   * Get Issue Security Schemes
  * Get Issue Security Scheme
  * Get Issue Security Level Members
  * Get Issue All Types
  * Get Alternative Issue Types
  *   * Get Issue Type Property Keys
  * Get Issue Type Property
  * Get All Issue Type Schemes
  * Get Issue Type Schemes Mapping
  * Get Issue Type Scheme For Projects
  * Get Issue Type Screen Schemes
  * Get Issue Type Screen Scheme Mappings
  * Get Issue Type Screen Scheme Project Associations
  *   * Get Field Auto Complete For Query String
  *   * Get My Permissions
  *   *   * Get Current User
  * Get Notification Schemes
  * Get Notification Scheme
  * Get All Permissions
  * Get All Permission Schemes
  * Get Permission Scheme
  * Get Permission Scheme Grants
  * Get Permission Scheme Grant
  *   *   * Get All Project Avatars
  *   * Get All Project Categories
  * Get Project Category By Id
  * Get Project Components Paginated
  * Get Project Components
  *   *   * Get Project Issue Security Scheme
  * Get Notification Scheme For Project
  * Get Assigned Permission Scheme
  * Get Project Property Keys
  *   *   *   * Get Project Role Details
  *   * Get Security Levels For Project
  *   * Get All Project Types
  * Get All Accessible Project Types
  * Get Accessible Project Type By Key
* Get Issue Security Scheme
  * Get Issue Security Level Members
  * Get Issue All Types
  * Get Alternative Issue Types
  *   * Get Issue Type Property Keys
  * Get Issue Type Property
  * Get All Issue Type Schemes
  * Get Issue Type Schemes Mapping
  * Get Issue Type Scheme For Projects
  * Get Issue Type Screen Schemes
  * Get Issue Type Screen Scheme Mappings
  * Get Issue Type Screen Scheme Project Associations
  *   * Get Field Auto Complete For Query String
  *   * Get My Permissions
  *   *   * Get Current User
  * Get Notification Schemes
  * Get Notification Scheme
  * Get All Permissions
  * Get All Permission Schemes
  * Get Permission Scheme
  * Get Permission Scheme Grants
  * Get Permission Scheme Grant
  *   *   * Get All Project Avatars
  *   * Get All Project Categories
  * Get Project Category By Id
  * Get Project Components Paginated
  * Get Project Components
  *   *   * Get Project Issue Security Scheme
  * Get Notification Scheme For Project
  * Get Assigned Permission Scheme
  * Get Project Property Keys
  *   *   *   * Get Project Role Details
  *   * Get Security Levels For Project
  *   * Get All Project Types
  * Get All Accessible Project Types
  * Get Accessible Project Type By Key
  * Get Project Type By Key
  * Get Project Versions Paginated
  * Get Project Versions
  * Validate Project Key
  * Get Valid Project Key
  * Get Valid Project Name
  *   *   * Get All Project Roles
  * Get Project Role Actors For Role
  * Get Project Role By Id
  *   * Get Available Screen Fields
  * Get All Screen Tabs
  * Get All Screen Tab Fields
  * Get Screen Schemes
  * (Deprecated) Search For Issues Using JQL
  * Search For Issues Using JQL (Paginated)
  * Get Issue Security Level
  *   * Get Issue Navigator Default Columns
  *   *   * Get Status Categories
  * Get Status Category
  *   * Find Bulk Assignable Users
  * Find Assignable Users
  *   * Bulk Get Users Migration
  * Get User Default Columns
  *   * Get User Email Bulk
  *   * Find Users With All Permissions
  * Find Users For Picker
  * Get User Property Keys
  *   *   * Find Users By Query
  * Find User Keys By Query
  * Find Users With Browse Permission
  * Get All Users Default
  *   *   * Get Version Related Issues
  * Get Version Unresolved Issues
  * Get Dynamic Webhooks For App
  * Get Failed Webhooks
  * Get Workflow Transition Rule Configurations
  * Get Workflows Paginated
  * Get Workflow Transition Properties
  * Get All Workflow Schemes
  * Get Workflow Scheme
  * Get Default Workflow
  * Get Workflow Scheme Draft
  * Get Draft Default Workflow
  * Get Workflow Scheme Draft Issue Type
  *   * Get Workflow Scheme Issue Type
  * Get Workflow Scheme Project Associations
  *   * Get Ids Of Worklogs Deleted Since
  * Get Ids Of Worklogs Modified Since
  * Addon Properties Resource get Addon Properties get
  * Addon Properties Resource get Addon Property get
  * Dynamic Modules Resource get Modules get
  *   * Set Application Property
  *   *   * Select Time Tracking Implementation
  * Set Shared Time Tracking Configuration
  * Update Custom Field Options
  *   * Set Dashboard Item Property
  * Update Custom Field
  * Update Custom Field Context
  *   * Add Issue Types To Context
  * Update Custom Field Option
  * Reorder Custom Field Options
  * Assign Projects To Custom Field Context
  * Update Issue Field Option
  * Assign Field Configuration Scheme To Project
  *   *   * Set Default Share Scope
  * Set Favourite For Filter
  *   *   * Update Issue Link Type
  *   * Bulk Set Issue Property
  * Update Remote Issue Link
  *   *   * Update Issue Type
  * Set Issue Type Property
  * Update Issue Type Scheme
  * Add Issue Types To Issue Type Scheme
  * Reorder Issue Types In Issue Type Scheme
  * Assign Issue Type Scheme To Project
  * Update Issue Type Screen Scheme
  * Append Mappings For Issue Type Screen Scheme
  * Update Default Screen Scheme
  * Assign Issue Type Screen Scheme To Project
  *   * Update Permission Scheme
  * Update Project Avatar
  *   * Update Project Category
  * Update Project Email
  * Assign Permission Scheme
  *   * Fully Update Project Role
  *   *   * Update Screen Scheme
  * Set Issue Navigator Default Columns
  *   *   *   *   *   * Update Workflow Transition Rule Configurations
  * Update Workflow Transition Property
  * Update Workflow Scheme
  * Update Default Workflow
  * Update Workflow Scheme Draft
  * Update Draft Default Workflow
  * Set Workflow Scheme Draft Issue Type
  * Update Draft Workflow Mapping
  * Set Workflow Scheme Issue Type
  * Associate Scheme With Project
  * Update Workflow Mapping
  * Addon Properties Resource put Addon Property put
## Get Comments By Ids
`<jira:create-rest-api3-comment-list>`
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 for the project containing the comment.
  * If issue-level security 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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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.

  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Component
`<jira:create-rest-api3-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 for the project in which the component is created
  * **Administer Jira** global permission.


This operation makes an HTTP POST request to the /rest/api/3/component endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Custom Field Options
`<jira:create-rest-api3-custom-field-option-by-field-id>`
This operation is deprecated and becomes unavailable on 8 May 2021. Use Create custom field options (context) instead. See Deprecation of custom field options 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.
This operation makes an HTTP POST request to the /rest/api/3/customField/{fieldId}/option endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Field Id | 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**.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Dashboard
`<jira:create-rest-api3-dashboard>`
Creates a dashboard.
**Permissions required:**
None.
This operation makes an HTTP POST request to the /rest/api/3/dashboard endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER
## Create Dashboard
`<jira:create-rest-api3-dashboard>`
Creates a dashboard.
**Permissions required:**
None.
This operation makes an HTTP POST request to the /rest/api/3/dashboard endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Copy Dashboard
`<jira:create-rest-api3-dashboard-copy-by-id>`
Copies a dashboard. Any values provided in the `dashboard` parameter replace those in the copied dashboard.
**Permissions required:**
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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Analyse Expression
`<jira:create-rest-api3-expression-analyse>`
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.
**Permissions required** :
None.
This operation makes an HTTP POST request to the /rest/api/3/expression/analyse endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Enumeration, one of:
  * SYNTAX
  * 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.

  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Evaluate Jira Expression
`<jira:create-rest-api3-expression-eval>`
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 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): The current user. Always available and equal to `null` if the request is anonymous.
  * `app` (App): The Connect app that made the request. Available only for authenticated requests made by Connect Apps (read more here: Authentication for Connect apps).
  * `issue` (Issue): The current issue. Available only when the issue is provided in the request context object.
  * `issues` (List of Issues): A collection of issues matching a JQL query. Available only when JQL is provided in the request context object.
  * `project` (Project): The current project. Available only when the project is provided in the request context object.
  * `sprint` (Sprint): The current sprint. Available only when the sprint is provided in the request context object.
  * `board` (Board): The current board. Available only when the board is provided in the request context object.
  * `serviceDesk` (ServiceDesk): The current service desk. Available only when the service desk is provided in the request context object.
  * `customerRequest` (CustomerRequest): 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/eval endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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://developer.atlassian.com/cloud/jira/platform/jira-expressions/#restrictions). Useful when designing and debugging your expressions.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Custom Field
`<jira:create-rest-api3-field>`
Creates a custom field.
**Permissions required:**
**Administer Jira** global permission.
This operation makes an HTTP POST request to the /rest/api/3/field endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Custom Field Context
`<jira:create-rest-api3-field-context-by-field-id>`
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.
This operation makes an HTTP POST request to the /rest/api/3/field/{fieldId}/context endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Field Id | The ID of the custom field.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Remove Issue Types From Context
`<jira:create-rest-api3-field-context-issuetype-remove-by-field-id-context-id>`
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.
This operation makes an HTTP POST request to the /rest/api/3/field/{fieldId}/context/{contextId}/issuetype/remove endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Field Id | The ID of the custom field.  
Context Id | The ID of the context.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Custom Query Parameters  
Custom Headers  
Response Timeout | Timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations
| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Get Custom Field Contexts For Projects And Issue Types
`<jira:create-rest-api3-field-context-mapping-by-field-id>`
Returns a paginated list of project and issue type mappings and, for each mapping, the ID of a custom field context 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.
This operation makes an HTTP POST request to the /rest/api/3/field/{fieldId}/context/mapping endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Field Id | The ID of the custom field.  
Start At | The index of the first item to return in a page of results (page offset).  
Max Results | The maximum number of items to return per page.  
the content to use | #[payload]  
Output Mime Type | 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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
Array of * Any  
---  
### For Configurations
  * Configurations


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


## Create Custom Field Option
`<jira:create-rest-api3-field-context-option-by-field-id-context-id>`
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.
This operation makes an HTTP POST request to the /rest/api/3/field/{fieldId}/context/{contextId}/option endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Field Id | The ID of the custom field.  
Context Id | The ID of the context.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Remove Custom Field Context From Projects
`<jira:create-rest-api3-field-context-project-remove-by-field-id-context-id>`
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.
This operation makes an HTTP POST request to the /rest/api/3/field/{fieldId}/context/{contextId}/project/remove endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Field Id | The ID of the custom field.  
Context Id | The ID of the context.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations
| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Issue Field Option
`<jira:create-rest-api3-field-option-by-field-key>`
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.
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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Field Key |  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"`

  
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  
Custom Headers  
Response Timeout | The timeout for requests to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Filter
`<jira:create-rest-api3-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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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]`.

  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Add Share Permission
`<jira:create-rest-api3-filter-permission-by-id>`
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 and the user must own the filter.
This operation makes an HTTP POST request to the /rest/api/3/filter/{id}/permission endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The ID of the filter.  
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
## Add Share Permission
`<jira:create-rest-api3-filter-permission-by-id>`
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 and the user must own the filter.
This operation makes an HTTP POST request to the /rest/api/3/filter/{id}/permission endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The ID of the filter.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
Array of Any  
---  
**Attributes Type** |  Http Response Attributes  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Group
`<jira:create-rest-api3-group>`
Creates a group.
**Permissions required:**
Site administration (that is, member of the **site-admin** [group](https://confluence.atlassian.com/x/24xjL)).
This operation makes an HTTP POST request to the /rest/api/3/group endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Add User To Group
`<jira:create-rest-api3-group-user>`
Adds a user to a group.
**Permissions required:** Site administration (that is, member of the **site-admin** [group](https://confluence.atlassian.com/x/24xjL)).
This operation makes an HTTP POST request to the /rest/api/3/group/user endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
groupname | The name of the group (case sensitive).  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Issue
`<jira:create-rest-api3-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.
## Create Issue
`<jira:create-rest-api3-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://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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Update History | 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.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Add Attachment
`<jira:create-rest-api3-issue-attachments-by-issue-id-or-key>`
Adds one or more attachments to an issue. Attachments are posted as multipart/form-data RFC 1867.
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` 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 for the project that the issue is in.
  * If issue-level security 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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Issue Id Or Key | The ID or key of the issue that attachments are added to.  
File Name | File name of the uploaded attachment.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
Array of Any  
---  
**Attributes Type** |  Http Response Attributes  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Issues
`<jira:create-rest-api3-issue-bulk>`
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 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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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
**Permissions required:**
**Browse projects** and **Create issues** project permissions 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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Add Comment
`<jira:create-rest-api3-issue-comment-by-issue-id-or-key>`
Adds a comment to an issue. This operation can be accessed anonymously.
**Permissions required:**
  * **Browse projects** and **Add comments** project permission for the project that the issue containing the comment is in.
  * If issue-level security 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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Issue Id Or Key | The ID or key of the issue.  
Use `expand` to include additional information about comments in the response. This parameter accepts `renderedBody`, which returns the comment body rendered in HTML.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Link Issues
`<jira:create-rest-api3-issue-link>`
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 enabled. This resource returns nothing on the creation of an issue link. To obtain the ID of the issue link, use `linked issue key?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 for all the projects containing the issues to be linked,
  * **Link issues** project permission on the project containing the from (outward) issue,
  * If issue-level security 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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Issue Link Type
`<jira:create-rest-api3-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 enabled.
**Permissions required:**
**Administer Jira** global permission.
This operation makes an HTTP POST request to the /rest/api/3/issueLinkType endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER
## Create Issue Link Type
`<jira:create-rest-api3-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 enabled.
**Permissions required:**
**Administer Jira** global permission.
This operation makes an HTTP POST request to the /rest/api/3/issueLinkType endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Notify
`<jira:create-rest-api3-issue-notify-by-issue-id-or-key>`
Creates an email notification for an issue and adds it to the mail queue.
**Permissions required:**
  * **Browse Projects** project permission for the project that the issue is in.
  * If issue-level security 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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Issue Id Or Key | ID or key of the issue that the notification is sent for.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Bulk Set Issues Properties
`<jira:create-rest-api3-issue-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, 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 for the project containing the issue.
  * If issue-level security 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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Or Update Remote Issue Link
`<jira:create-rest-api3-issue-remotelink-by-issue-id-or-key>`
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. This operation can be accessed anonymously.
**Permissions required:**
  * **Browse projects** and **Link issues** project permission for the project that the issue is in.
  * If issue-level security 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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Issue Id Or Key | The ID or key of the issue.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS
This operation makes an HTTP POST request to the /rest/api/3/issue/{issueIdOrKey}/remotelink endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Issue Id Or Key | The ID or key of the issue.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Do Transition
`<jira:create-rest-api3-issue-transitions-by-issue-id-or-key>`
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 for the project that the issue is in.
  * If issue-level security 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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Issue Id Or Key | The ID or key of the issue.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Add Vote
`<jira:create-rest-api3-issue-votes-by-issue-id-or-key>`
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 for details.
**Permissions required:**
  * **Browse projects** project permission for the project that the issue is in.
  * If issue-level security 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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Issue Id Or Key | The ID or key of the issue.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Add Watcher
`<jira:create-rest-api3-issue-watchers-by-issue-id-or-key>`
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 for details.
**Permissions required:**
  * **Browse projects** project permission for the project that the issue is in.
  * If issue-level security is configured, issue-level security permission to view the issue.
  * To add users other than themselves to the watchlist, **Manage watcher list** project permission 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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Issue Id Or Key | The ID or key of the issue.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER
This operation makes an HTTP POST request to the /rest/api/3/issue/{issueIdOrKey}/watchers endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Issue Id Or Key | The ID or key of the issue.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Add Worklog
`<jira:create-rest-api3-issue-worklog-by-issue-id-or-key>`
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. This operation can be accessed anonymously.
**Permissions required:**
  * **Browse projects** and **Work on issues** project permission for the project that the issue is in.
  * If issue-level security 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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Issue Id Or Key | The ID or key the issue.  
Notify Users | Whether users watching the issue are notified by email.  
Adjust Estimate |  Enumeration, one of:
  * LEAVE
  * MANUAL

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

  
New Estimate | 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 | 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`.  
Use `expand` to include additional information about work logs in the response. This parameter accepts `properties`, which returns worklog properties.  
Override Editable Flag | 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.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Issue Type
`<jira:create-rest-api3-issuetype>`
Creates an issue type and adds it to the default issue type scheme. **Permissions required:** **Administer Jira** global permission.
This operation makes an HTTP POST request to the /rest/api/3/issuetype endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Issue Type Avatar
`<jira:create-rest-api3-issuetype-avatar2-by-id>`
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: \ --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`
## Create Issue Type Avatar
`<jira:create-rest-api3-issuetype-avatar2-by-id>`
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: \ --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.
This operation makes an HTTP POST request to the /rest/api/3/issuetype/{id}/avatar2 endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The ID of the issue type.  
The X coordinate of the top-left corner of the crop region.  
The Y coordinate of the top-left corner of the crop region.  
The length of each side of the crop region.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Issue Type Scheme
`<jira:create-rest-api3-issuetypescheme>`
Creates an issue type scheme.
**Permissions required:**
**Administer Jira** global permission.
This operation makes an HTTP POST request to the /rest/api/3/issuetypescheme endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Issue Type Screen Scheme
`<jira:create-rest-api3-issuetypescreenscheme>`
Creates an issue type screen scheme.
**Permissions required:**
**Administer Jira** global permission.
This operation makes an HTTP POST request to the /rest/api/3/issuetypescreenscheme endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE
| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Remove Mappings From Issue Type Screen Scheme
`<jira:create-rest-api3-issuetypescreenscheme-mapping-remove-by-issue-type-screen-scheme-id>`
Removes issue type to screen scheme mappings from an issue type screen scheme.
**Permissions required:**
**Administer Jira** global permission.
This operation makes an HTTP POST request to the /rest/api/3/issuetypescreenscheme/{issueTypeScreenSchemeId}/mapping/remove endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Issue Type Screen Scheme Id | The ID of the issue type screen scheme.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Match Issues
`<jira:create-rest-api3-jql-match>`
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 for the project that the issue is in.
  * If issue-level security 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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Parse Jql Queries
`<jira:create-rest-api3-jql-parse>`
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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
validation |  Enumeration, one of:
  * STRICT

| 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.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE
| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Migrate Queries
`<jira:create-rest-api3-jql-pdcleaner>`
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.
**Permissions required:**
Permission to access Jira.
This operation makes an HTTP POST request to the /rest/api/3/jql/pdcleaner endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Get Bulk Permissions
`<jira:create-rest-api3-permissions-check>`
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 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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Get Permitted Projects
`<jira:create-rest-api3-permissions-project>`
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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors.  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE
| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors.  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Permission Scheme
`<jira:create-rest-api3-permissionscheme>`
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.
This operation makes an HTTP POST request to the /rest/api/3/permissionscheme endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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.

  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Permission Grant
`<jira:create-rest-api3-permissionscheme-permission-by-scheme-id>`
Creates a permission grant in a permission scheme.
**Permissions required:**
**Administer Jira** global permission.
This operation makes an HTTP POST request to the /rest/api/3/permissionscheme/{schemeId}/permission endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Scheme Id | The ID of the permission scheme in which to create a new permission grant.  
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.

  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Project
`<jira:create-rest-api3-project>`
Creates a project based on a project type template, as shown in the following table:
Project Type Key | Project Template Key  
---|---  
`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`  
`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.
**Permissions required:**
**Administer Jira** global permission.
This operation makes an HTTP POST request to the /rest/api/3/project endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Archive Project
`<jira:create-rest-api3-project-archive-by-project-id-or-key>`
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.
This operation makes an HTTP POST request to the /rest/api/3/project/{projectIdOrKey}/archive endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Project Id Or Key | The project ID or project key (case sensitive).  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Project Avatar
`<jira:create-rest-api3-project-avatar2-by-project-id-or-key>`
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.


`curl --request POST ` `--user 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**
This operation makes an HTTP POST request to the /rest/api/3/project/{projectIdOrKey}/avatar2 endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Project Id Or Key | The ID or (case-sensitive) key of the project.  
The X coordinate of the top-left corner of the crop region.  
The Y coordinate of the top-left corner of the crop region.  
The length of each side of the crop region.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Project Category
`<jira:create-rest-api3-project-category>`
Creates a project category.
**Permissions required:**
**Administer Jira** global permission
This operation makes an HTTP POST request to the /rest/api/3/projectCategory endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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
| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Project Category
`<jira:create-rest-api3-project-category>`
Creates a project category.
**Permissions required:**
**Administer Jira** global permission
This operation makes an HTTP POST request to the /rest/api/3/projectCategory endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Delete Project Asynchronously
`<jira:create-rest-api3-project-delete-by-project-id-or-key>`
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.
This operation makes an HTTP POST request to the /rest/api/3/project/{projectIdOrKey}/delete endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Project Id Or Key | The project ID or project key (case sensitive).  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## restore
`<jira:create-rest-api3-project-restore-by-project-id-or-key>`
Restores a project from the Jira recycle bin.
**Permissions required:**
**Administer Jira** global permission
This operation makes an HTTP POST request to the /rest/api/3/project/{projectIdOrKey}/restore endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Project Id Or Key | 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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Add Actor Users
`<jira:create-rest-api3-project-role-by-project-id-or-key-id>`
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 for the project or **Administer Jira** global permission.
This operation makes an HTTP POST request to the /rest/api/3/project/{projectIdOrKey}/role/{id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Project Id Or Key | The project ID or project key (case sensitive).  
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.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS
| 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 |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Project Role
`<jira:create-rest-api3-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
This operation makes an HTTP POST request to the /rest/api/3/role endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Add Project Role Actors To Role
`<jira:create-rest-api3-role-actors-by-id>`
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
This operation makes an HTTP POST request to the /rest/api/3/role/{id}/actors endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Partial Update Project Role
`<jira:create-rest-api3-role-by-id>`
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
This operation makes an HTTP POST request to the /rest/api/3/role/{id} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations
| 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 |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Screen
`<jira:create-rest-api3-screens>`
Creates a screen with a default field tab.
**Permissions required:**
**Administer Jira** global permission
This operation makes an HTTP POST request to the /rest/api/3/screens endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Add Field To Default Screen
`<jira:create-rest-api3-screens-add-to-default-by-field-id>`
Adds a field to the default tab of the default screen.
**Permissions required:**
**Administer Jira** global permission
This operation makes an HTTP POST request to the /rest/api/3/screens/addToDefault/{fieldId} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Field Id | The ID of the field.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Add Screen Tab
`<jira:create-rest-api3-screens-tabs-by-screen-id>`
Creates a tab for a screen.
**Permissions required:**
**Administer Jira** global permission
This operation makes an HTTP POST request to the /rest/api/3/screens/{screenId}/tabs endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Screen Id | The ID of the screen.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Add Screen Tab Field
`<jira:create-rest-api3-screens-tabs-fields-by-screen-id-tab-id>`
Adds a field to a screen tab.
**Permissions required:**
**Administer Jira** global permission
This operation makes an HTTP POST request to the /rest/api/3/screens/{screenId}/tabs/{tabId}/fields endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Screen Id | The ID of the screen.  
The ID of the screen tab.  
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
### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Add Screen Tab Field
`<jira:create-rest-api3-screens-tabs-fields-by-screen-id-tab-id>`
Adds a field to a screen tab.
**Permissions required:**
**Administer Jira** global permission
This operation makes an HTTP POST request to the /rest/api/3/screens/{screenId}/tabs/{tabId}/fields endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Screen Id | The ID of the screen.  
The ID of the screen tab.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Move Screen Tab Field
`<jira:create-rest-api3-screens-tabs-fields-move-by-screen-id-tab-id-id>`
Moves a screen tab field. If `after` and `position` are provided in the request, `position` is ignored.
**Permissions required:**
**Administer Jira** global permission
This operation makes an HTTP POST request to the /rest/api/3/screens/{screenId}/tabs/{tabId}/fields/{id}/move endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Screen Id | The ID of the screen.  
The ID of the screen tab.  
The ID of the field.  
the content to use | #[payload]  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Move Screen Tab
`<jira:create-rest-api3-screens-tabs-move-by-screen-id-tab-id-pos>`
Moves a screen tab.
**Permissions required:**
**Administer Jira** global permission
This operation makes an HTTP POST request to the /rest/api/3/screens/{screenId}/tabs/{tabId}/move/{pos} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Screen Id | The ID of the screen.  
The ID of the screen tab.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Screen Scheme
`<jira:create-rest-api3-screenscheme>`
Creates a screen scheme.
**Permissions required:**
**Administer Jira** global permission
This operation makes an HTTP POST request to the /rest/api/3/screenscheme endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations
| 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 |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Search For Issues Using Jql Post
`<jira:create-rest-api3-search>`
Searches for issues using JQL. 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 for the project containing the issue.
  * If issue-level security is configured, issue-level security permission to view the issue.


This operation makes an HTTP POST request to the /rest/api/3/search endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Cancel Task
`<jira:create-rest-api3-task-cancel-by-task-id>`
Cancels a task.
**Permissions required:**
Either of:
  * **Administer Jira** global permission
  * Creator of the task


This operation makes an HTTP POST request to the /rest/api/3/task/{taskId}/cancel endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The ID of the task.  
Config Ref |  ConfigurationProvider | Name of the configuration to use to execute this component.  
Custom Query Parameters  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Store Avatar
`<jira:create-rest-api3-universal-avatar-type-owner-by-type-entity-id>`
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.


`curl --request POST ` `--user 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
This operation makes an HTTP POST request to the /rest/api/3/universal_avatar/type/{type}/owner/{entityId} endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
Enumeration, one of:
  * PROJECT
  * ISSUETYPE

| The avatar type.  
Entity Id | The ID of the item the avatar is associated with.  
The X coordinate of the top-left corner of the crop region.  
The Y coordinate of the top-left corner of the crop region.  
The length of each side of the crop region.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER
| The avatar type.  
Entity Id | The ID of the item the avatar is associated with.  
The X coordinate of the top-left corner of the crop region.  
The Y coordinate of the top-left corner of the crop region.  
The length of each side of the crop region.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create User
`<jira:create-rest-api3-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
This operation makes an HTTP POST request to the /rest/api/3/user endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Create Version
`<jira:create-rest-api3-version>`
Creates a project version. This operation can be accessed anonymously.
**Permissions required:**
**Administer Jira** global permission or **Administer Projects** project permission for the project the version is added to.
This operation makes an HTTP POST request to the /rest/api/3/version endpoint.
### Parameters
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations


### Throws
  * JIRA:BAD_REQUEST
  * JIRA:CLIENT_ERROR
  * JIRA:CONNECTIVITY
  * JIRA:INTERNAL_SERVER_ERROR
  * JIRA:NOT_ACCEPTABLE
  * JIRA:NOT_FOUND
  * JIRA:RETRY_EXHAUSTED
  * JIRA:SERVER_ERROR
  * JIRA:SERVICE_UNAVAILABLE
  * JIRA:TIMEOUT
  * JIRA:TOO_MANY_REQUESTS
  * JIRA:UNAUTHORIZED
  * JIRA:UNSUPPORTED_MEDIA_TYPE


## Move Version
`<jira:create-rest-api3-version-move-by-id>`
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
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
Configuration | The name of the configuration to use.  
The ID of the version to be moved.  
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  
Custom Headers  
Response Timeout | The timeout for request to the remote service.  
Response Timeout Unit |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

| Time unit that qualifies the **Response Timeout**.  
Streaming Type |  Enumeration, one of:
  * ALWAYS
  * NEVER

| Defines 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 | 
  *   * Reconnect Forever

| A retry strategy in case of connectivity errors  
### Output
**Attributes Type** |  Http Response Attributes  
---|---  
### For Configurations
  * Configurations