> For the complete documentation index, see [llms.txt](https://docs.hivel.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hivel.ai/integrations/deployments-and-incidents/deployment-api.md).

# Deployment API

Deployment Event Tracking

Track deployment activity across your organization to calculate key DORA metrics: deployment frequency and change failure rate. Choose where your deployment events are sent based on your Hivel deployment model.

#### Overview

Deployment events capture when releases happen in your environment. Hivel processes these events to generate DORA metrics and insights that measure your team's delivery performance.

#### Choose Your Connection Method

**Hivel-Managed (Default)** 

**Use this if:** You use Hivel's hosted platform.

Send deployment events directly to Hivel's cloud platform:

* **Endpoint:** `app.hivel.ai` (global) or `app.hivel.in` (India region)
* **Data:** Events are received and processed by Hivel's servers
* **Best for:** Organizations using Hivel's standard SaaS offering

{% content-ref url="/pages/zRYnS7KqgcOqICcQilL1" %}
[Hivel-managed](/integrations/deployments-and-incidents/deployment-api/hivel-managed.md)
{% endcontent-ref %}

**Self-Hosted**

**Use this if:** You run Hivel's on-premises deployment.

Send deployment events to a webhook gateway running on your own infrastructure. Events remain within your network before reaching your Hivel instance.

* **Deployment:** Webhook gateway runs entirely on your infrastructure
* **Data:** Events stay on your network - no external transmission before internal delivery
* **Best for:** Organizations with on-premises or self-managed Hivel deployments requiring data residency control

{% content-ref url="/pages/9vRiwzyMPs7voo4VUBKJ" %}
[On-Premises](/integrations/deployments-and-incidents/deployment-api/on-premises.md)
{% endcontent-ref %}