docs/content/rest/enterprise-admin/pre-receive-environments.md

2.1 KiB

title shortTitle allowTitleToDifferFromFilename intro versions topics autogenerated
REST API endpoints for pre-receive environments Pre-receive environments true Use the REST API to create, list, update and delete environments for pre-receive hooks.
ghes
*
API
rest

About pre-receive environments

These endpoints are only available to authenticated site administrators. Normal users will receive a 404 response.

{% data reusables.user-settings.enterprise-admin-api-classic-pat-only %}

Object attributes

Pre-receive Environment

Name Type Description
name string The name of the environment as displayed in the UI.
image_url string URL to the tarball that will be downloaded and extracted.
default_environment boolean Whether this is the default environment that ships with {% data variables.product.product_name %}.
download object This environment's download status.
hooks_count integer The number of pre-receive hooks that use this environment.

Pre-receive Environment Download

Name Type Description
state string The state of the most recent download.
downloaded_at string The time when the most recent download started.
message string On failure, this will have any error messages produced.

Possible values for state are not_started, in_progress, success, failed.