Skip to content

Check the saved Jira connection again

POST
/v1/projects/{id}/integrations/jira/test
curl --request POST \
--url https://beta-api.plune.ai/v1/projects/example/integrations/jira/test \
--cookie plune_session=<plune_session>

Owner only. Asks Jira two things with the saved token, and keeps what it found as the connection’s state: site (GET https://<site>/_edge/tenant_info, with no credentials, answers with the cloud id) and token (GET /rest/api/3/mypermissions?permissions=BROWSE_PROJECTS answers, at the site for a classic token and through api.atlassian.com/ex/jira/<cloudId> for one with scopes, and the account may browse projects). token is skipped when site failed. A 401 stores rejected and the allowlist refusal ip_blocked; Plune tries nothing again by itself, and a token Jira rejected is not sent again: only PUT with a token revives it. Requests are https only, to a public address, follow no redirect, read at most 1 MB and take 15 seconds at most; what Jira answers is read for its status, the two fields and — in an error answer — the sentence of its IP allowlist refusal, never kept or shown. At most 10 checks a minute for a project, this and PUT together. Session cookie only.

id
required
string

An id from GET /v1/projects

What the check found. A failed check carries one of these codes and Plune’s own sentence in message — never what Jira wrote: ip_blocked — Jira’s IP allowlist refused Plune: add the addresses of outboundAddresses to it (its sentence read in the body of an error answer, whatever its status; a 2xx that quotes it is an answer); rejected — a 401: the token is mistyped, expired or revoked, or the other kind of token was chosen; forbidden — a 403; unavailable — a 404: no site there, or no API for this kind of token; busy — a 429: Jira asks Plune to slow down, retryAfterSec when it said how long; invalid — another 4xx, or an answer Plune cannot read; unreachable — a 5xx, the network or the 15 s deadline; redirect — Jira sent Plune elsewhere, which Plune does not follow; too_large — an answer over 1 MB; no_permission — the token reads, but the account may not browse projects.

Media type application/json

What a check found: site, then token (skipped when the site failed). ok is true when both passed.

object
ok
required
boolean
steps
required
Array<object>
object
step
required
string
Allowed values: site token
result
required
string
Allowed values: ok failed skipped
code

Present exactly when result is failed.

string
Allowed values: ip_blocked rejected forbidden unavailable busy invalid unreachable redirect too_large no_permission
message

Present exactly when result is failed: Plune’s sentence for the page. Never what Jira wrote.

string
retryAfterSec

busy only: the seconds Jira asked to wait, when it said.

integer
testedAt
required
string format: date-time
Example
{
"ok": true,
"steps": [
{
"step": "site",
"result": "ok"
},
{
"step": "token",
"result": "ok"
}
],
"testedAt": "2026-09-16T09:12:04.151Z"
}

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
{
"error": "project owner only"
}

No such project among yours, or no Jira was ever connected

Media type application/json
object
error
required
string
Examples

No such project among yours

{
"error": "project 'u-shop::default' not found"
}

No token is saved (disconnected), Jira rejected the saved one (it is not sent again: each refused try brings Jira’s CAPTCHA nearer), or the saved one does not open under this server’s key: connect again with a token. Or the connection changed while it was being checked (a Disconnect or a save): what the check found is not written over it

Media type application/json
object
error
required
string
Examples

Disconnected

{
"error": "no token is saved — connect again with a token"
}

More than 10 checks in a minute for this project. 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 tokens under; nothing was sent

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