The Jira Cloud site the project is connected to
const url = 'https://beta-api.plune.ai/v1/projects/example/integrations/jira';const options = {method: 'GET', 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 GET \ --url https://beta-api.plune.ai/v1/projects/example/integrations/jira \ --cookie plune_session=<plune_session>Every member of the project reads it, a reader too: connection is null when no Jira was ever connected, otherwise the site, the kind of token, its state, when it was last checked and when Jira last answered, who connected it and when, and who disconnected it and when. The owner reads the e-mail as well; nobody reads the token. state is no_token after Disconnect, and otherwise paused exactly when PUT and POST …/test would be refused for the tier (with TIER_LIMITS_ENFORCE=true, a tier without issue trackers: Free, an expired tier or one switched off). paidOnly is that same refusal, said with nothing connected and after Disconnect too. outboundAddresses are the addresses Plune calls Jira from. A project you are not in answers 404, the same as one that does not exist. Session cookie only: a CLI token is refused with 401.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”An id from GET /v1/projects
Responses
Section titled “ Responses ”The connection, or null, and the outbound addresses
object
null when no Jira was ever connected.
object
working; rejected — Jira answered 401: a new token is needed, and Plune does not send this one again; ip_blocked — Jira’s IP allowlist refused Plune; error — another failure, stateReason says which; paused — the project’s tier does not include issue trackers (Free, an expired tier or one switched off) while the operator enforces the tier limits: nothing is asked of Jira and nothing is lost; no_token — disconnected: the settings stay, a token connects it again (a disconnected connection reads no_token, never paused).
The code of the last failure when state is rejected, ip_blocked or error; null otherwise.
When the saved connection was last checked: the save itself, or POST …/test.
When Jira last answered a read — what Plune holds of Jira is as of this time.
userId of the owner who connected it, or last changed it.
userId of the owner who disconnected it; null while connected.
Owner only: the e-mail of the Atlassian account.
The poll by filter (#1070) as a member reads it.
object
When the next pass is due; null while the poll is off.
A pass runs now (it holds the lease). While it does, nextPollAt is a watchdog for a lost pass, not the next poll: the pass sets that when it ends.
The start of the last pass that read to the end: the next asks Jira for what changed since 10 minutes before it.
null until the first pass, and after the filter changed.
object
Issues that wrote nothing: their mirror keeps the same updated, it is detached for a reason other than left_filter, or a bug adopted into Plune holds the issue - it is not mirrored again (decision of 12.11.2026).
null — read to the end, or to its cap of issues (the next pass goes on from there a minute later). rejected / ip_blocked — Jira answered 401 / its IP allowlist refused Plune: the connection takes that state and polling stops. busy — Jira answered 429: the pass is tried again after its Retry-After at the least (retryAt), four tries in all; unreachable — a 5xx, the network, a redirect: the same tries. filter_unavailable — the saved filter is gone, or the account may not see it; filter_invalid — Jira refused the JQL; too_large — a page of the search is over 1 MB; bugs_disabled — the project’s Bugs section is off; bugs_quota — the project holds as many bugs as its plan allows; token_unreadable — this server’s key does not open the saved token. All but the first two are tried again at the next poll.
When a busy or unreachable pass is tried again; null otherwise.
The start of the last full pass (ADR 0072 §3): the whole filter read, not only what changed, and every mirror of the site the filter no longer holds detached with left_filter. The next one is due 24 h later; absent until the first.
The left_filter mirrors this pass attached again: their issue is in the filter again - any pass that brings it, the full one or the window. Absent on an outcome from before the re-attach.
The mirrors this pass detached as left_filter - only a full pass does. Absent on an outcome from before the full pass.
Only when a full pass that read to the end detached nothing by its safety valve: empty - the filter held no issue; too_many - more than half of the site’s filter mirrors, and 5 or more, would have gone at once (fewer than 5 are detached). mirrors: the site’s live mirrors the filter brought; missing: those the pass did not find. Nothing is detached until a full pass finds the filter as it should be.
object
The event → transition table (#1071, Р325): the issue its transitions were read from, and the transition «verified» makes - null, a comment only.
object
object
The addresses Plune calls Jira from, for a Jira that takes requests from an allowlist only (ADR 0072 §9). A change of them is announced 14 days ahead. Empty when the server names none.
true exactly when PUT would be refused now for the tier (403, issue_trackers: TIER_LIMITS_ENFORCE=true and a tier without issue trackers — Free, an expired tier or one switched off); worked out as paused is. Unlike paused it says so with nothing connected and after Disconnect. Always false in report mode.
Example
{ "connection": { "site": "acme.atlassian.net", "tokenKind": "scoped", "state": "working", "stateReason": null, "checkedAt": "2026-09-16T09:12:04.151Z", "lastReadAt": "2026-09-16T09:12:04.151Z", "connectedBy": "u-shop", "connectedAt": "2026-09-16T09:12:04.151Z", "disconnectedBy": null, "disconnectedAt": null, "poll": { "enabled": true, "filterId": "10010", "jql": null, "intervalMinutes": 15, "nextPollAt": "2026-10-29T09:15:00.000Z", "running": false, "lastPolledAt": "2026-09-16T09:12:04.151Z", "last": { "startedAt": "2026-09-16T09:12:04.151Z", "finishedAt": "2026-09-16T09:12:04.151Z", "created": 2, "updated": 1, "unchanged": 4, "error": null, "retryAt": null, "fullPassAt": "2026-09-16T09:12:04.151Z", "reattached": 0, "detached": 0 } }, "write": { "sampleIssue": "ACME-123", "verified": { "id": "31", "name": "Close issue", "toId": "10002", "toName": "Done" } } }, "outboundAddresses": [ "203.0.113.7" ], "paidOnly": false}No / invalid session — a CLI token is refused here
No such project among yours
object
Example
{ "error": "project 'u-shop::default' not found"}The server has no key to keep tokens under — the operator has not set JIRA_ENCRYPTION_KEY
object
Example
{ "error": "Jira is not configured on this server — contact your operator"}