​
Authentication

This provider requires authentication.

  • email: Atlassian Jira Email (required: True, sensitive: False)
  • api_token: Atlassian Jira API Token (required: True, sensitive: True)
  • host: Atlassian Jira Host (required: True, sensitive: False)

Certain scopes may be required to perform specific actions or queries via the provider. Below is a summary of relevant scopes and their use cases:

  • BROWSE_PROJECTS: Browse Jira Projects (mandatory)
  • CREATE_ISSUES: Create Jira Issues (mandatory)
  • CLOSE_ISSUES: Close Jira Issues
  • EDIT_ISSUES: Edit Jira Issues
  • DELETE_ISSUES: Delete Jira Issues
  • MODIFY_REPORTER: Modify Jira Issue Reporter

​
In workflows

This provider can be used in workflows.

As “step” to query data, example:

steps:
    - name: Query jira
      provider: jira
      config: "{{ provider.my_provider_name }}"
      with:
        ticket_id: {value}  # The ticket id of the issue, optional.
        board_id: {value}  # The board id of the issue.

As “action” to make changes or update data, example:

actions:
    - name: Query jira
      provider: jira
      config: "{{ provider.my_provider_name }}"
      with:
        summary: {value}  # The summary of the issue.
        description: {value}  # The description of the issue.
        issue_type: {value}  # The type of the issue.
        project_key: {value}  # The project key of the issue.
        board_name: {value}  # The board name of the issue.
        issue_id: {value}  # The issue id of the issue.
        labels: {value}  # The labels of the issue.
        components: {value}  # The components of the issue.
        custom_fields: {value}  # The custom fields of the issue.

Check the following workflow examples:

​
Connecting with the Provider

  1. Go to https://id.atlassian.com/manage-profile/security/api-tokens to Create API token and generated token should be passed to jira authentication.
  2. Get host and board_id from your respective board from its URL.
  3. Get project_key from your project > settings > details.
  4. email would be same as of your account email.

​
Notes