Skip to content

Test the GitHub Issues connection again

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

The owner’s: the two checks of PUT on the saved connection; what they found is stored (rejected on a 401, error otherwise). A rejected token is not sent again: 409 until the owner connects with a new one. Ten a minute a project. A failed step carries one code - never what GitHub wrote: rejected (401), forbidden (403), unavailable (404/410: no such repository for this token), busy (403/429 of a rate limit, retryAfterSec from retry-after or x-ratelimit-reset), invalid, unreachable (5xx, the network, 15 s), redirect, too_large, issues_disabled (the repository has Issues off).

id
required
string

An id from GET /v1/projects

What the checks found

Media type application/json
object
ok
required
boolean
steps
required
Array<object>
object
step
required
string
Allowed values: repository issues
result
required
string
Allowed values: ok failed skipped
code
string
Allowed values: rejected forbidden unavailable busy invalid unreachable redirect too_large issues_disabled
retryAfterSec
integer
testedAt
required
string format: date-time
error
string
Example
{
"ok": true,
"steps": [
{
"step": "repository",
"result": "ok"
},
{
"step": "issues",
"result": "ok"
}
],
"testedAt": "2026-09-16T09:12:04.151Z"
}

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"
}

No token saved, the token was rejected, or this server cannot read it; or the connection changed meanwhile

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"
}