Skip to main content
GET
/
v1
/
apps
/
{app_id}
/
deploys
/
webhook
Get Deploy Webhook URL
curl --request GET \
  --url https://api.vertracloud.app/v1/apps/{app_id}/deploys/webhook
{
  "response": {
    "repo_owner": "owner_name",
    "repo_name": "repository_name",
    "webhook_url": "https://api.vertracloud.app/v1/apps/123/deploys/receiver/webhook"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt

Use this file to discover all available pages before exploring further.

​
app_id
string
required
The ID of the application whose webhook URL will be retrieved.

​
Response

​
response
object
Contains repository and webhook details.
{
  "response": {
    "repo_owner": "owner_name",
    "repo_name": "repository_name",
    "webhook_url": "https://api.vertracloud.app/v1/apps/123/deploys/receiver/webhook"
  }
}

​
Error Responses

​
code
string
Possible error codes:
  • UNAUTHORIZED: User is not authenticated or lacks permissions.
  • PLAN_RESTRICTED_FEATURE: User plan does not support auto-deploy.
  • DEPLOYMENT_NOT_FOUND: Webhook integration not found for the application.
​
message
string
A descriptive message providing additional details about the error.
{
  "code": "DEPLOYMENT_NOT_FOUND"
}