Check the saved Jira connection again
const url = 'https://beta-api.plune.ai/v1/projects/example/integrations/jira/test';const options = {method: 'POST', headers: {cookie: 'plune_session=<plune_session>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”An id from GET /v1/projects
Responses
Section titled “ Responses ”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.
What a check found: site, then token (skipped when the site failed). ok is true when both passed.
object
object
Present exactly when result is failed.
Present exactly when result is failed: Plune’s sentence for the page. Never what Jira wrote.
busy only: the seconds Jira asked to wait, when it said.
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
object
Example
{ "error": "project owner only"}No such project among yours, or no Jira was ever connected
object
Examples
No such project among yours
{ "error": "project 'u-shop::default' not found"}Nothing saved to check
{ "error": "no Jira is connected"}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
object
Examples
Disconnected
{ "error": "no token is saved — connect again with a token"}Jira rejected the saved token
{ "error": "the token was rejected — connect again with a new token"}The server’s key was replaced
{ "error": "the saved token cannot be read on this server — replace it"}Changed during the check
{ "error": "the connection changed while it was being checked — try again"}More than 10 checks in a minute for this project. Retry-After carries the seconds until the window rolls over
object
Example generated
{ "error": "example"}Headers
Section titled “Headers ”Seconds until the window rolls over
The server has no key to keep tokens under; nothing was sent
object
Example
{ "error": "Jira is not configured on this server — contact your operator"}