Skip to content

The transitions a sample Jira issue offers

GET
/v1/projects/{id}/integrations/jira/transitions
curl --request GET \
--url 'https://beta-api.plune.ai/v1/projects/example/integrations/jira/transitions?issue=KAN-1' \
--cookie plune_session=<plune_session>

Owner only (#1071, Р325). What GET /rest/api/3/issue/{key}/transitions of the connection’s Jira gives for any issue of the project - each with its id, name and target status, and whether its screen asks a required field (Plune cannot fill one, so a write skips it). Feeds the event → transition table of PUT …/jira/write. Needs a working connection and a tier with issue trackers. Session cookie only.

id
required
string

An id from GET /v1/projects

issue
required
string
Example
KAN-1

The key of any issue of the Jira project.

The transitions

Media type application/json
object
issue
required
string
transitions
required
Array
object
id
required
string
name
required
string
toId
required
string
toName
required
string
requiredFields
required

Its screen has a required field: Plune cannot fill it, so a write skips it.

boolean
Example
{
"issue": "ACME-123",
"transitions": [
{
"id": "31",
"name": "Close issue",
"toId": "10002",
"toName": "Done",
"requiredFields": false
}
]
}

Not the key of a Jira issue

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

No / invalid session — a CLI token is refused here

You are in the project, but not as its owner; or (with TIER_LIMITS_ENFORCE=true) a tier without the issue_trackers permission

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

No such project among yours, no Jira was ever connected, or Jira does not give the sample issue (jira_issue_unavailable)

Media type application/json
object
error
required
string
Example
{
"error": "Jira did not give issue KAN-9: it does not exist, or the account of the connection may not see it",
"code": "jira_issue_unavailable",
"key": "KAN-9"
}

The connection is not working (jira_not_working, with its state)

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

Jira rejected the token (jira_token_rejected, the connection becomes rejected), refused Plune’s address (jira_ip_blocked), asked to slow down (jira_rate_limited) or did not answer (jira_unreachable)

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

The server has no key to keep tokens under

Media type application/json
object
error
required
string
Example
{
"error": "Jira is not configured on this server — contact your operator"
}