Skip to main content

​
Add comment to issue

Action ID: tools.jira.add_issue_comment Add a comment to an issue in Jira. Reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/#api-rest-api-3-issue-issueidorkey-comment-post

​
Secrets

Required secrets:
  • jira: required values JIRA_USEREMAIL, JIRA_API_TOKEN.

​
Input fields

​
comment
string
required
Comment to add to the issue.
​
issue_id_or_key
string
required
ID or key of the issue to add a comment to.
​
base_url
string | null
Jira tenant URL (e.g. https://tracecat.atlassian.net).Default: null.

​
Assign issue

Action ID: tools.jira.assign_issue Assign an issue to a user. Reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-assignee-put

​
Secrets

Required secrets:
  • jira: required values JIRA_USEREMAIL, JIRA_API_TOKEN.

​
Input fields

​
issue_key
string
required
Jira issue key (e.g. TC-123)
​
user_id
string
required
Jira user ID (e.g. 1234567890)
​
base_url
string | null
Jira tenant URL (e.g. https://tracecat.atlassian.net)Default: null.

​
Create issue

Action ID: tools.jira.create_issue Create a new issue in Jira. Reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-post

​
Secrets

Required secrets:
  • jira: required values JIRA_USEREMAIL, JIRA_API_TOKEN.

​
Input fields

​
description
string
required
Detailed description of the incident.
​
issue_type_id
string
required
Jira issue type ID.
​
priority_id
string
required
Priority ID. Must be one of the priorities in the priority scheme.
​
project_id
string
required
Jira project ID.
​
summary
string
required
Brief one-line summary of the incident.
​
base_url
string | null
Jira tenant URL (e.g. https://tracecat.atlassian.net).Default: null.
​
fields
array[object]
List of fields to add to the issue. Each field is an object with the following keys: - key: The Jira custom field ID. - value: The field value. For example: [ {"key": "customfield_10000", "value": "New value"}, {"key": "customfield_10001", "value": "Another value"} ]Default: [].
​
tags
array[string]
Tags to categorize the incident. Added as Jira labels.Default: [].

​
Get fields

Action ID: tools.jira.get_fields Get a list of fields from Jira. Reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-fields/#api-group-issue-fields

​
Secrets

Required secrets:
  • jira: required values JIRA_USEREMAIL, JIRA_API_TOKEN.

​
Input fields

​
base_url
string | null
Jira tenant URL (e.g. https://tracecat.atlassian.net)Default: null.

​
Get issue

Action ID: tools.jira.get_issue Get an issue from Jira by ID or key. Reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-get

​
Secrets

Required secrets:
  • jira: required values JIRA_USEREMAIL, JIRA_API_TOKEN.

​
Input fields

​
issue_id_or_key
string
required
ID or key of the issue to get.
​
base_url
string | null
Jira tenant URL (e.g. https://tracecat.atlassian.net)Default: null.
​
fields
string
A list of fields to return for each issue, use it to retrieve a subset of fields. This parameter accepts a comma-separated list of strings. Expand options include: *all, *navigable, summary, comment,-description, -comment (defaults to *all).Default: "*all".

​
Get priorities by scheme

Action ID: tools.jira.get_priorities Get a list of priorities from Jira for a given priority scheme. Reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-priority-schemes/#api-rest-api-3-priorityscheme-schemeid-priorities-get

​
Secrets

Required secrets:
  • jira: required values JIRA_USEREMAIL, JIRA_API_TOKEN.

​
Input fields

​
priority_scheme_id
string
required
Jira priority scheme ID.
​
base_url
string | null
Jira tenant URL (e.g. https://tracecat.atlassian.net)Default: null.
​
limit
integer
Maximum number of priorities to return.Default: 50.

​
Get priority schemes

Action ID: tools.jira.get_priority_schemes Get a list of priority schemes from Jira. Reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-priority-schemes/#api-rest-api-3-priorityscheme-get

​
Secrets

Required secrets:
  • jira: required values JIRA_USEREMAIL, JIRA_API_TOKEN.

​
Input fields

​
base_url
string | null
Jira tenant URL (e.g. https://tracecat.atlassian.net)Default: null.
​
limit
integer
Maximum number of priority schemes to return.Default: 50.

​
Get projects

Action ID: tools.jira.get_projects Get a list of projects from Jira. Reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-projects/#api-rest-api-3-project-search-get

​
Secrets

Required secrets:
  • jira: required values JIRA_USEREMAIL, JIRA_API_TOKEN.

​
Input fields

​
base_url
string | null
Jira tenant URL (e.g. https://tracecat.atlassian.net)Default: null.
​
limit
integer
Maximum number of projects to return.Default: 50.

​
Get transitions

Action ID: tools.jira.get_transitions Get a list of available transitions for an issue. Reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-transitions-get

​
Secrets

Required secrets:
  • jira: required values JIRA_USEREMAIL, JIRA_API_TOKEN.

​
Input fields

​
issue_id_or_key
string
required
ID or key of the issue to get transitions for.
​
base_url
string | null
Jira tenant URL (e.g. https://tracecat.atlassian.net).Default: null.

​
Get user ID

Action ID: tools.jira.get_user_id Get a user ID from Jira. Reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-user-search/#api-rest-api-3-user-search-get

​
Secrets

Required secrets:
  • jira: required values JIRA_USEREMAIL, JIRA_API_TOKEN.

​
Input fields

​
username
string
required
Jira username (e.g. john.doe@example.com)
​
base_url
string | null
Jira tenant URL (e.g. https://tracecat.atlassian.net)Default: null.

​
Jira MCP

Action ID: tools.jira.mcp Use AI to interact with Jira through Atlassian’s remote MCP server. Reference: https://support.atlassian.com/atlassian-rovo-mcp-server/docs/getting-started-with-the-atlassian-remote-mcp-server/

​
Secrets

Required secrets:
  • jira_mcp_oauth: OAuth token JIRA_MCP_USER_TOKEN.
Optional secrets:
  • anthropic: optional values ANTHROPIC_API_KEY.
  • openai: optional values OPENAI_API_KEY.
  • gemini: optional values GEMINI_API_KEY.
  • amazon_bedrock: optional values AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION, AWS_PROFILE, AWS_ROLE_ARN, AWS_SESSION_TOKEN, AWS_BEARER_TOKEN_BEDROCK, AWS_MODEL_ID, AWS_INFERENCE_PROFILE_ID.
  • custom-model-provider: optional values CUSTOM_MODEL_PROVIDER_API_KEY, CUSTOM_MODEL_PROVIDER_MODEL_NAME, CUSTOM_MODEL_PROVIDER_BASE_URL.
  • azure_openai: optional values AZURE_API_BASE, AZURE_API_VERSION, AZURE_DEPLOYMENT_NAME, AZURE_API_KEY, AZURE_AD_TOKEN.
  • azure_ai: optional values AZURE_API_BASE, AZURE_API_KEY, AZURE_AI_MODEL_NAME.

​
Input fields

​
instructions
string
required
Instructions for the agent.
​
model_name
string
required
Name of the model to use.
​
model_provider
string
required
Provider of the model to use.
​
user_prompt
string
required
User prompt to the agent.

​
Search issues

Action ID: tools.jira.search_issues Search for issues in Jira using JQL. Reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-search/#api-rest-api-3-search-jql-get

​
Secrets

Required secrets:
  • jira: required values JIRA_USEREMAIL, JIRA_API_TOKEN.

​
Input fields

​
jql
string
required
JQL query to search for issues.
​
base_url
string | null
Jira tenant URL (e.g. https://tracecat.atlassian.net)Default: null.
​
fields
string
A list of fields to return for each issue, use it to retrieve a subset of fields. This parameter accepts a comma-separated list. Expand options include: *all, *navigable, summary, comment, -description, -comment (defaults to id).Default: "id".
​
max_results
integer
Maximum number of results to return.Default: 100.
​
next_page
string
Next page token to get the next page of results. If not provided, the first page of results will be returned.Default: null.

​
Update issue description

Action ID: tools.jira.update_issue_description Update the description of an existing issue in Jira. Reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-put

​
Secrets

Required secrets:
  • jira: required values JIRA_USEREMAIL, JIRA_API_TOKEN.

​
Input fields

​
description
string
required
Updated description of the incident.
​
issue_id_or_key
string
required
ID or key of the issue to update.
​
base_url
string | null
Jira tenant URL (e.g. https://tracecat.atlassian.net).Default: null.

​
Update issue fields

Action ID: tools.jira.update_issue_fields Update the fields of an existing issue in Jira. Reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-put

​
Secrets

Required secrets:
  • jira: required values JIRA_USEREMAIL, JIRA_API_TOKEN.

​
Input fields

​
fields
array[object]
required
List of fields to update in the issue. For example usage: [ {"customfield_10000": "New value"}, {"customfield_10001": ["Another value"]} ]
​
issue_id_or_key
string
required
ID or key of the issue to update.
​
base_url
string | null
Jira tenant URL (e.g. https://tracecat.atlassian.net).Default: null.

​
Update issue status

Action ID: tools.jira.update_issue_status Update the status of an issue. Reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-transitions-post

​
Secrets

Required secrets:
  • jira: required values JIRA_USEREMAIL, JIRA_API_TOKEN.

​
Input fields

​
issue_id_or_key
string
required
ID or key of the issue to update.
​
transition_id
string
required
ID of the transition to perform.
​
base_url
string | null
Jira tenant URL (e.g. https://tracecat.atlassian.net).Default: null.

​
Upload attachment

Action ID: tools.jira.upload_attachment Upload an attachment to a Jira issue. Reference: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-attachments/#api-rest-api-3-issue-issueidorkey-attachments-post

​
Secrets

Required secrets:
  • jira: required values JIRA_USEREMAIL, JIRA_API_TOKEN.

​
Input fields

​
base64_content
string
required
Base64 encoded content of the file to upload.
​
content_type
string
required
MIME type of the file (e.g., “application/pdf”, “image/png”, “text/plain”).
​
filename
string
required
Name of the file to upload.
​
ticket
string
required
Jira issue key or ID to upload the attachment to (e.g., “PROJ-123”).
​
base_url
string | null
Jira tenant URL (e.g. https://tracecat.atlassian.net).Default: null.