Jira
API actions for the Jira integration.
Jira
Connect to Jira using an API token to browse projects and manage issues.
Add a comment to a Jira issue.
Post a comment to a Jira issue thread.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
issue_key | string | Yes | Jira issue key to comment on |
body | string | Yes | Comment body to post |
Response
{
"comment": {
"body": "Sample text content",
"id": "abc123xyz789",
"issue_key": {
"id": "abc123",
"name": "Sample"
}
}
}Create a Jira issue.
Create a new Jira issue with summary, optional description, priority, and assignee.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
project_key | string | Yes | Jira project key to create the issue in |
summary | string | Yes | Issue summary/title |
description | string | No | issue description supporting Jira markup |
issue_type | string | No | Issue type name |
priority | string | No | Priority name to apply |
assignee_account_id | string | No | account ID of the user to assign the issue to |
Response
{
"issue": {
"id": "abc123xyz789",
"key": "example_value",
"self": "example_value"
}
}Get a Jira issue.
Fetch Jira issue details including summary and status.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
issue_key | string | Yes | Jira issue key to fetch |
Response
{
"issue": {
"id": "abc123xyz789",
"key": "example_value",
"status": {
"id": "1",
"name": "In Progress"
},
"summary": "example_value"
}
}List Jira projects.
Retrieve accessible Jira projects for the connected account.
Response
{
"projects": [
{
"id": "proj123",
"key": "PROJ",
"name": "Development"
}
]
}List transitions for a Jira issue.
Retrieve available workflow transitions for a Jira issue based on its current status.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
issue_key | string | Yes | Jira issue key to get transitions for |
Response
{
"transitions": [
{
"id": "21",
"name": "In Progress",
"to": {
"id": "3",
"name": "In Progress"
}
}
]
}Search Jira issues.
Run a JQL query to find Jira issues.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
jql | string | Yes | JQL query string to execute |
max_results | number | No | Maximum number of results to return (1-100) |
next_page_token | string | No | Cursor token for fetching the next page of results |
Response
{
"issues": [
{
"id": "item123",
"key": "PROJ-1",
"status": {
"id": "1",
"name": "To Do"
},
"summary": "Sample Task"
}
]
}Transition a Jira issue.
Move a Jira issue to a new workflow state by transition ID.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
issue_key | string | Yes | Jira issue key to transition |
transition_id | string | Yes | Transition ID to apply to the issue |
Response
{
"issue_key": {
"id": "abc123",
"name": "Sample"
},
"transition_id": {
"id": "abc123",
"name": "Sample"
}
}