> ## 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.

# Obtener URL del webhook de despliegue

> Devuelve la URL del webhook de despliegue de GitHub y la información del repositorio de una aplicación.

**app\_id** `string` *required*

El ID de la aplicación de la que se obtendrá la URL del webhook.

### Respuesta

**response** `object`

Contiene los detalles del repositorio y del webhook.

**Mostrar objeto**

**repo\_owner** `string`

El propietario del repositorio de GitHub.

**repo\_name** `string`

El nombre del repositorio de GitHub.

**webhook\_url** `string`

La URL del webhook de despliegue.

**branch** `string | null`

La rama cuyos push despliegan la aplicación. `null` significa `main` o `master`.

```json theme={null}
{
  "response": {
    "repo_owner": "owner_name",
    "repo_name": "repository_name",
    "webhook_url": "https://api.vertracloud.app/v1/apps/123/deploys/receiver/webhook",
    "branch": "develop"
  }
}
```

### Respuestas de error

**code** `string`

Códigos de error posibles:

* `AUTH_TOKEN_MISSING`, `API_KEY_INVALID`, `SESSION_REVOKED`: Falta la cabecera `Authorization`, la clave de API no es válida o la sesión del panel fue revocada (`401`).
* `API_KEY_IP_DENIED`, `API_KEY_SCOPE_DENIED`: La clave de API se usa desde una IP fuera de su lista de permitidas, o no tiene el scope que requiere la ruta (`403`).
* `ACCESS_DENIED`: El recurso pertenece a otra cuenta, o no tienes el permiso de workspace necesario para él (`403`).
* `PLAN_RESTRICTED_FEATURE`: El plan del usuario no admite el despliegue automático.
* `DEPLOYMENT_NOT_FOUND`: No se encontró el webhook de integración de la aplicación.

**message** `string`

Una descripción detallada con información adicional sobre el error.

```json theme={null}
{
  "code": "DEPLOYMENT_NOT_FOUND"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.