Apps

Install an app

Installs the exact app revision the administrator approved for all of the organization's repositories (current and future) or the selected ones, creating its bot principal for this organization. It approves the organization's pending requests for the app and returns the manifest's setup URL, with the installation ID, the organization and the install link's state. Requires authenticated authority and enforces current resource policy.

post/api/orgs/{slug}/installations

Request

  • Base URL
    https://git.cafe
  • Auth
    • API key in cookie gc-session
    • or HTTP bearer
    • or HTTP basic
    • or HTTP token

Path parameters

slugstring required

Request body

appIdstring required
revisioninteger required
manifestHashstring required
repositorySelection'all' | 'selected'
repositoriesstring[]
statestring

Response

Response for status 201

idstring required
appIdstring required
appstring required
namestring required
publisherstring required
iconUrlstring nullable required
orgstring required
revisioninteger required
latestRevisioninteger required
versioninteger required
repositorySelection'all' | 'selected' required
repositoriesstring[] required
pausedAtstring nullable required
suspendedAtstring nullable required
uninstalledAtstring nullable required
installedAtstring required
lastUsedAtstring nullable required
setupUrlstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.