JIRA Integration

Full JIRA Cloud integration with 21 endpoints.

Configuration

{
  "credentials": {
    "jira": {
      "baseUrl": "https://your-org.atlassian.net",
      "email": "{{env.JIRA_EMAIL}}",
      "apiToken": "{{env.JIRA_API_TOKEN}}"
    }
  }
}

Endpoints

Issues

Method	Endpoint	Description
GET	/integrations/jira/issues/:key	Get issue
POST	/integrations/jira/issues	Create issue
PUT	/integrations/jira/issues/:key	Update issue
DELETE	/integrations/jira/issues/:key	Delete issue
GET	/integrations/jira/search	Search issues (JQL)

Projects

Method	Endpoint	Description
GET	/integrations/jira/projects	List projects
GET	/integrations/jira/projects/:key	Get project

Transitions

Method	Endpoint	Description
GET	/integrations/jira/issues/:key/transitions	Get transitions
POST	/integrations/jira/issues/:key/transitions	Transition issue

Users

Method	Endpoint	Description
GET	/integrations/jira/users/search	Search users
GET	/integrations/jira/myself	Get current user

Actions (for workflows)

getIssue

{
  "integration": "jira",
  "action": "getIssue",
  "params": {
    "issueKey": "PROJ-123"
  }
}

createIssue

{
  "integration": "jira",
  "action": "createIssue",
  "params": {
    "projectKey": "PROJ",
    "summary": "New issue",
    "description": "Details...",
    "issueType": "Task"
  }
}

updateIssue

{
  "integration": "jira",
  "action": "updateIssue",
  "params": {
    "issueKey": "PROJ-123",
    "fields": {
      "summary": "Updated title",
      "priority": { "name": "High" }
    }
  }
}

searchIssues

{
  "integration": "jira",
  "action": "searchIssues",
  "params": {
    "jql": "project = PROJ AND status = Open",
    "maxResults": 50
  }
}

transitionIssue

{
  "integration": "jira",
  "action": "transitionIssue",
  "params": {
    "issueKey": "PROJ-123",
    "transitionId": "31"
  }
}

Examples

Get Issue

curl http://localhost:3000/integrations/jira/issues/PROJ-123 \
  -H "Authorization: Bearer <token>"

Create Issue

curl -X POST http://localhost:3000/integrations/jira/issues \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "fields": {
      "project": { "key": "PROJ" },
      "summary": "New bug",
      "issuetype": { "name": "Bug" }
    }
  }'

Search Issues

curl "http://localhost:3000/integrations/jira/search?jql=status=Open" \
  -H "Authorization: Bearer <token>"

Workflow Example

{
  "id": "analyze-ticket",
  "steps": [
    {
      "id": "fetch",
      "type": "integration",
      "integration": "jira",
      "action": "getIssue",
      "params": { "issueKey": "{{input.key}}" }
    },
    {
      "id": "analyze",
      "type": "llm",
      "prompt": "Analyze: {{steps.fetch.result.fields.summary}}"
    },
    {
      "id": "comment",
      "type": "integration",
      "integration": "jira",
      "action": "addComment",
      "params": {
        "issueKey": "{{input.key}}",
        "body": "{{steps.analyze.result}}"
      }
    }
  ]
}