GitHub API (unofficial showcase)
POST/orgs/{org}/properties/installations

Register an app installation for external custom properties

Registers a GitHub App installation so it can read and write external custom properties for an organization, and assigns it a display name.

The display name must be 1 to 15 characters and contain only letters and numbers. Capitalization is preserved as entered.

An app installation can only be registered once, and its display name can't be changed afterward. Calling with an app installation that has already been registered returns a 422 response with an already_exists error code for installation_id. If the display name is already in use by another app installation in the organization, the response is 422 with an already_exists error code for display_name. An invalid display name also returns 422.

The app installation being registered must have write or admin permission for organization external custom properties for repositories. If it doesn't, the response is 422. This is the permission of the installation being registered, which isn't necessarily the caller.

Uninstalling the GitHub App unregisters it, and removes the external custom properties it created.

To use this endpoint, the authenticated caller must have the organization_external_properties_for_repos:admin permission.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 2 body fields
orgstringrequired
The organization name. The name is not case sensitive.
installation_idintegeroptional
The unique identifier of the GitHub App installation to register for managing external custom properties. When authenticating as a GitHub App installation, this defaults to the authenticated installation and can be omitted. It is required for all other callers (users and fine-grained personal access tokens).
display_namestringrequired
The display name for this app installation's external custom properties in the organization. Must be 1 to 15 characters and contain only letters and numbers. Capitalization is preserved as entered. This can't be changed after the app installation is registered.

4 status codes
201Response
display_namestringrequired
The display name assigned to the app installation's external custom properties in the organization.
installationobjectrequired
The GitHub App installation that was registered.
403Forbidden
messagestringoptional
documentation_urlstringoptional
urlstringoptional
statusstringoptional
404Resource not found
messagestringoptional
documentation_urlstringoptional
urlstringoptional
statusstringoptional
422Validation failed, or the endpoint has been spammed.
messagestringrequired
documentation_urlstringrequired
errorsarray<object>optional

Error handling

A 403 is returned: Forbidden. A 404 is returned: Resource not found. A 422 is returned: Validation failed, or the endpoint has been spammed.