> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keephq.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira On-Prem Provider

> Jira On-Prem Provider is a provider used to query data and creating issues in Jira

This is on-prem Jira provider documentation, for regular please check [Jira Provider](./jira-provider.md).

## Authentication

This provider requires authentication.

* **host**: Jira Host (required: True, sensitive: False)
* **personal\_access\_token**: Jira PAT (required: True, sensitive: True)
* **ticket\_creation\_url**: URL for creating new tickets (required: False, 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:

```yaml theme={null}
steps:
    - name: Query jiraonprem
      provider: jiraonprem
      config: "{{ provider.my_provider_name }}"
      with:
        ticket_id: {value}  # The ticket id.
        board_id: {value}  # The board id.
```

As "action" to make changes or update data, example:

```yaml theme={null}
actions:
    - name: Query jiraonprem
      provider: jiraonprem
      config: "{{ provider.my_provider_name }}"
      with:
        summary: {value}  
        description: {value}  
        issue_type: {value}  
        project_key: {value}  
        board_name: {value}  
        issue_id: {value}  
        labels: {value}  
        components: {value}  
        custom_fields: {value}  
        priority: {value}  
```

Check the following workflow example:

* [jira\_on\_prem.yml](https://github.com/keephq/keep/blob/main/examples/workflows/jira_on_prem.yml)