Skip to content

The issue types of a Jira project

GET
/v1/bugs/jira/create/issuetypes
curl --request GET \
--url 'https://beta-api.plune.ai/v1/bugs/jira/create/issuetypes?project=ACME' \
--cookie plune_session=<plune_session>

The second step (#1072): Jira’s GET /rest/api/3/issue/createmeta/{project}/issuetypes, every page; sub-tasks are left out, since they need a parent. Refused as the projects are. At most 60 calls a minute from you.

X-Plune-Project
string

Which of your projects to act in — an id from GET /v1/projects. Absent, your default project. A project you are not a member of answers 404, the same as one that does not exist. Ignored under a bearer token, which is bound to the project it was minted in.

project
required
string
Example
ACME

The key of the Jira project, any case.

The issue types

Media type application/json
object
project
required
string
issueTypes
required

Sub-tasks left out: they need a parent.

Array<object>
object
id
required
string
name
required
string
Example
{
"project": "ACME",
"issueTypes": [
{
"id": "10001",
"name": "Bug"
}
]
}

Not the key of a Jira project; Jira was not asked

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

No / invalid session — a CLI token is refused here, as on the routes of the Jira connection

Media type application/json
object
error
required
string
Example
{
"error": "sign in required"
}

You are in the project as a reader, or not as its owner; or (only once the operator sets TIER_LIMITS_ENFORCE=true) a tier without the issue_trackers permission, answered in English then Ukrainian, naming the feature, with feature and tier

Media type application/json
object
error
required
string
Example
{
"error": "project owner only"
}

Jira does not give the project or its issue type - it does not exist, or the account may not create there (jira_project_unavailable, with project); the bug is not one of the project’s live bugs; or the project of X-Plune-Project is not one of yours

Media type application/json
object
error
required
string
Example
{
"error": "Jira did not give project NOPE or its issue type: it does not exist, or the account of the connection may not create issues there",
"code": "jira_project_unavailable",
"project": "NOPE"
}

The Bugs section is off in this project (code: bugs_disabled); or the project’s Jira connection is not working (code: jira_not_working, state one of rejected, ip_blocked, paused, no_token, error, none — none when it was never connected, no_token after a Disconnect, error when this server cannot read the saved token; paused is not met here, a tier that refuses Jira is the 403); Jira was not asked

Media type application/json
object
error
required
string
Examples

The connection was disconnected

{
"error": "the project’s Jira connection is not working — its owner sees why in Settings → Integrations",
"code": "jira_not_working",
"state": "no_token"
}

Jira did not give the issue for a reason of its own; what Jira wrote is never passed on. jira_token_rejected — a 401: the connection becomes rejected and its token is not sent again until the owner connects anew; jira_ip_blocked — Jira’s IP allowlist refused Plune: the connection becomes ip_blocked; jira_rate_limited — a 429, with retryAfterSec (Jira’s Retry-After, else 30); jira_unreachable — a 5xx, the network, the 15 s deadline, a redirect, an answer over 1 MB or one Plune cannot read. A 424 and not a 502/504: a proxy replaces the body of those

Media type application/json
object
error
required
string
Examples

Jira rejected the token

{
"error": "Jira rejected the token of the project’s connection — its owner connects it again with a new token",
"code": "jira_token_rejected"
}

Rate-limited: the per-route throttle, or the per-minute request limit of the plan an API token counts by (#1442; the body names the plan, #2092). Retry-After carries the seconds until the window rolls over.

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

Seconds until the window rolls over

The server has no key to keep Jira tokens under; Jira was not asked

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