Maton

Jira

Access the Jira Cloud API with managed OAuth authentication. Search issues with JQL, create and manage issues, and automate workflows.

Reference

List Projects

GET /jira/ex/jira/{cloudId}/rest/api/3/project
maton jira project list --cloud-id abc-123

Get Project

GET /jira/ex/jira/{cloudId}/rest/api/3/project/{projectKeyOrId}
maton jira project view PROJ --cloud-id abc-123

Search Issues (JQL)

GET /jira/ex/jira/{cloudId}/rest/api/3/search/jql?jql=project%3DPROJ%20order%20by%20created%20DESC&maxResults=20&fields=summary,status,assignee
maton jira issue search 'project = PROJ order by created DESC' --cloud-id abc-123 --limit 20 --fields summary,status,assignee

Get Issue

GET /jira/ex/jira/{cloudId}/rest/api/3/issue/{issueIdOrKey}
maton jira issue view PROJ-123 --cloud-id abc-123

Create Issue

POST /jira/ex/jira/{cloudId}/rest/api/3/issue
Content-Type: application/json

{
  "fields": {
    "project": {"key": "PROJ"},
    "summary": "Fix login",
    "issuetype": {"name": "Task"}
  }
}
maton jira issue create --cloud-id abc-123 --project PROJ --summary 'Fix login' --type Task

Update Issue

PUT /jira/ex/jira/{cloudId}/rest/api/3/issue/{issueIdOrKey}
Content-Type: application/json

{
  "fields": {
    "summary": "Updated summary"
  }
}
maton jira issue update PROJ-123 --cloud-id abc-123 --summary 'Updated summary'

Delete Issue

DELETE /jira/ex/jira/{cloudId}/rest/api/3/issue/{issueIdOrKey}
maton jira issue delete PROJ-123 --cloud-id abc-123

Assign Issue

PUT /jira/ex/jira/{cloudId}/rest/api/3/issue/{issueIdOrKey}/assignee
Content-Type: application/json

{
  "accountId": "712020:5aff718e-6fe0-4548-82f4-f44ec481e5e7"
}
maton jira issue update PROJ-123 --cloud-id abc-123 --assignee 712020:5aff718e-6fe0-4548-82f4-f44ec481e5e7

Get Transitions

GET /jira/ex/jira/{cloudId}/rest/api/3/issue/{issueIdOrKey}/transitions
maton jira transition list PROJ-123 --cloud-id abc-123

Transition Issue (change status)

POST /jira/ex/jira/{cloudId}/rest/api/3/issue/{issueIdOrKey}/transitions
Content-Type: application/json

{
  "transition": {"id": "31"}
}
maton jira transition apply PROJ-123 --cloud-id abc-123 --id 31

Get Comments

GET /jira/ex/jira/{cloudId}/rest/api/3/issue/{issueIdOrKey}/comment
maton jira comment list PROJ-123 --cloud-id abc-123

Add Comment

POST /jira/ex/jira/{cloudId}/rest/api/3/issue/{issueIdOrKey}/comment
Content-Type: application/json

{
  "body": {
    "type": "doc",
    "version": 1,
    "content": [{"type": "paragraph", "content": [{"type": "text", "text": "Comment text"}]}]
  }
}
maton jira comment add PROJ-123 --cloud-id abc-123 --body 'Comment text'

Get Current User

GET /jira/ex/jira/{cloudId}/rest/api/3/myself
maton jira whoami --cloud-id abc-123

Search Users

GET /jira/ex/jira/{cloudId}/rest/api/3/user/search?query=john
maton jira user search john --cloud-id abc-123

List Issue Types

GET /jira/ex/jira/{cloudId}/rest/api/3/issuetype
maton jira issuetype list --cloud-id abc-123

List Priorities

GET /jira/ex/jira/{cloudId}/rest/api/3/priority
maton jira priority list --cloud-id abc-123

List Statuses

GET /jira/ex/jira/{cloudId}/rest/api/3/status
maton jira status list --cloud-id abc-123

Resources

On this page