Organization API: Organization GitHub

The organization's GitHub App installations, as /api/v1/git/github serves an account's, so its deployments build from its repositories on every push.

Base URL: https://api.coritan.com/api/v1. Paths below are complete.

To try these requests in the browser, open the interactive Organization API reference.

GET /api/v1/orgs/{org_slug}/git/github/install

Where to send the browser to install the GitHub App for the account (or organization). url works for expires_in seconds; GitHub then comes back to return_to, a path on this storefront.

GET /api/v1/orgs/{org_slug}/git/github/installations

The owner's GitHub App installations by account, each with how many deployments clone through it, and the App itself.

POST /api/v1/orgs/{org_slug}/git/github/installations

Record the installation the callback's ticket names: 201 when it is new, 200 when it refreshed one the owner already had. A ticket another account or member started answers 403, a used one 409, and an installation another owner holds 409 installation_taken.

application/json (required)

DELETE /api/v1/orgs/{org_slug}/git/github/installations/{installation_ref}

Forget an installation. The deployments that cloned through it (detached) keep their repository address and build as a pasted repository would. The App stays installed on GitHub until its account uninstalls it there (manage_url).

GET /api/v1/orgs/{org_slug}/git/github/installations/{installation_ref}/repositories

One page of the repositories the installation reaches, for the repository picker. A suspended installation answers 409.