ownerstringrequired
repostringrequired
pre_receive_hook_idintegerrequired
pre_receive_hook_id parameter
Remove pre-receive hook enforcement for a repository
Deletes any overridden enforcement on this repository for the specified hook.
Responds with effective values inherited from owner and/or global level.
delete
http://HOSTNAME/api/v3/repos/{owner}/{repo}/pre-receive-hooks/{pre_receive_hook_id}
Path Parameters
Response
200 application/json
Response
200 application/json
Responds with effective values inherited from owner and/or global level.
repository-pre-receive-hook
idinteger
namestring
enforcementstring
configuration_urlstring
delete/repos/{owner}/{repo}/pre-receive-hooks/{pre_receive_hook_id}
Path Parameters
200 application/json
Get the configuration status
This endpoint allows you to check the status of the most recent configuration process:
Note that you may need to wait several seconds after you start a process before you can check its status.
The different statuses are:
| Status | Description |
|---|---|
PENDING |
The job has not started yet |
CONFIGURING |
The job is running |
DONE |
The job has finished correctly |
FAILED |
The job has finished unexpectedly |
get
http://HOSTNAME/api/v3/setup/api/configcheck
Response
200 application/json
Response
200 application/json
Response
configuration-status
statusstring
progressarray[object]
Show Child Parameters
get/setup/api/configcheck
200 application/json
Start a configuration process
This endpoint allows you to start a configuration process at any time for your updated settings to take effect:
post
http://HOSTNAME/api/v3/setup/api/configure
Response
202
Response
202
Response
post/setup/api/configure
202
Get the maintenance status
Check your installation’s maintenance status:
get
http://HOSTNAME/api/v3/setup/api/maintenance
Response
200 application/json
Response
200 application/json
Response
maintenance-status
statusstring
scheduled_timestring
connection_servicesarray[object]
Show Child Parameters
get/setup/api/maintenance
200 application/json
Enable or disable maintenance mode
Note: The request body for this operation must be submitted as application/x-www-form-urlencoded data. You can submit a parameter value as a string, or you can use a tool such as curl to submit a parameter value as the contents of a text file. For more information, see the curl documentation.
post
http://HOSTNAME/api/v3/setup/api/maintenance
Body
application/x-www-form-urlencoded
Body
application/x-www-form-urlencoded
maintenancestringrequired
A JSON string with the attributes enabled and when.
The possible values for enabled are true and false. When it’s false, the attribute when is ignored and the maintenance mode is turned off. when defines the time period when the maintenance was enabled.
The possible values for when are now or any date parseable by mojombo/chronic.
Response
200 application/json
Response
200 application/json
Response
maintenance-status
statusstring
scheduled_timestring
connection_servicesarray[object]
Show Child Parameters
post/setup/api/maintenance
Body
{
"maintenance": "{\"enabled\":true, \"when\":\"now\"}"
}
200 application/json