Skip to content

Set the poll by label of GitHub Issues

PUT
/v1/projects/{id}/integrations/github-issues/poll
curl --request PUT \
--url https://beta-api.plune.ai/v1/projects/example/integrations/github-issues/poll \
--header 'Content-Type: application/json' \
--cookie plune_session=<plune_session> \
--data '{ "enabled": true, "label": "plune" }'

The owner’s (ADR 0083 §2): the issues of the connected repository with label are mirrored on a schedule - GET /repos/{owner}/{repo}/issues with labels, state=all and since (what changed after the last pass’s start minus 10 minutes), pull requests left out; a full pass a day marks left_filter the mirrors the label no longer holds. A limit of GitHub (403/429 with retry-after or x-ratelimit-remaining: 0 and x-ratelimit-reset) puts the pass back for that wait. intervalMinutes 5-1440 (15 by default). Off with no label keeps the saved one. GitHub is not asked here. Audited as tracker_connection.

id
required
string

An id from GET /v1/projects

Media type application/json
object
enabled
required
boolean
label

One label; required to switch the poll on.

string
>= 1 characters <= 100 characters /^[^,]+$/
intervalMinutes
integer
>= 5 <= 1440
Example
{
"enabled": true,
"label": "plune"
}

Set

Media type application/json
object
connection
required
object
repository
required
string
state
required
string
Allowed values: working rejected error paused no_token
stateReason
required
string
nullable
checkedAt
required
string format: date-time
nullable
lastReadAt
required
string format: date-time
nullable
connectedBy
required
string
connectedAt
required
string format: date-time
disconnectedBy
required
string
nullable
disconnectedAt
required
string format: date-time
nullable
poll
required
object
enabled
required
boolean
label
required
string
nullable
intervalMinutes
required
integer
nextPollAt
required
string format: date-time
nullable
running
required
boolean
lastPolledAt
required
string format: date-time
nullable
last
required

What the last pass did - the shape of Jira’s poll outcome.

object
paidOnly
required
boolean
Example
{
"connection": {
"repository": "acme/shop",
"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,
"label": "plune",
"intervalMinutes": 15,
"nextPollAt": "2026-09-16T09:12:04.151Z",
"running": false,
"lastPolledAt": null,
"last": null
}
},
"paidOnly": false
}

Invalid body - on without a label, a label with a comma, an interval out of bounds

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

No / invalid session — a CLI token is refused here

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

Not the project’s owner; or (with TIER_LIMITS_ENFORCE=true) a tier without the issue_trackers permission, with feature and tier

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

Nothing connected, or not your project

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

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 INTEGRATIONS_ENCRYPTION_KEY; GitHub was not asked

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