Deploy webhook
Deploy an application from a secret URL, without a token.
POST/hooks/{id}/{secret}
Deploys the application like POST /api/v1/apps/{id}/deploy, but without a token: the secret in the URL authenticates the call. Add this URL as a push webhook in GitHub or GitLab. Copy the full URL from the application's page, in Settings → Deploy webhook. Anyone with it can trigger a deployment, so keep it secret. No request body is needed.
Path parameters
idstringrequiredIdentifier of the application, as returned by GET /api/v1/apps.
secretstringrequiredThe application's webhook secret.
curl -X POST 'https://admin.your-domain.com/hooks/3f9c2a7e/9b1d4e7a2c6f'Responses
202
202The deployment has started. The body is the plain text "deploy triggered".
"deploy triggered"404
404Unknown application, or wrong secret. Both answer the same, so the URL doesn't reveal whether an application exists.
No body.
429
429A deployment of this application is already running.
"a deploy is already in progress"