Finishes installing the GitHub App: GitHub sends the browser back with the installation, a code and the state you got from the overview.
HTTP
POST /integrations/github/installationsAccess: Session token only. API keys get 403 with insufficient_scope.
Role: Organisation owner or admin.
Request body #
JSON.
| Field | Type | Required | Description |
|---|---|---|---|
installationId | integer | yes | The id GitHub gives the installation, as sent back to the browser. |
code | string | yes | The code GitHub sent back to the browser. |
state | string | yes | The state from installUrl. |
JSON
{ "installationId": 12345678, "code": "...", "state": "..." }Response 200 #
The overview after connecting, as in GitHub overview.
Errors #
| Status | error | When |
|---|---|---|
| 401 | unauthenticated | The token is missing or not valid. |
| 403 | forbidden | You are not an owner or admin. |
| 503 | github_not_configured | The GitHub integration is not set up on this server. |
| 400 | invalid_state | state is not the one the overview gave you, or was made by someone else. |
| 502 | github_error | GitHub refused the request. message says why. |
| 429 | rate_limited | Too many requests, see Rate limiting. |
See Errors for the error format.