---
title: "POST /api/vpn-connectors/heartbeat"
method: POST
path: "/api/vpn-connectors/heartbeat"
tags: ["VpnConnectors"]
---

# POST /api/vpn-connectors/heartbeat

`POST /api/vpn-connectors/heartbeat`

## Request

- Base URL: `https://api-admin.hackgate.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api-admin.hackgate.io/api/vpn-connectors/heartbeat`
- Auth: HTTP bearer

## Request body

- VpnConnectorHeartbeatRequest
  - `connectorId` string, required
  - `credential` string, required
  - `version` string, nullable
  - `configRevision` integer
  - `diagnostics` string, nullable
  - `tunnelAddress` string, nullable
  - `dnsHealthy` boolean
  - `routesHealthy` boolean

## Response `200`

OK

- VpnConnectorHeartbeatResponse
  - `status` string, nullable
  - `receivedAt` string, date-time
  - `nextHeartbeatSeconds` integer
  - `configRevision` integer
  - `networks` VpnConnectorNetworkDto[], nullable
    - `cidr` string, nullable
  - `dnsZones` VpnConnectorDnsZoneDto[], nullable
    - `zone` string, nullable
    - `resolvers` string[], nullable
  - `targets` VpnConnectorTargetDto[], nullable
    - `type` string, nullable
    - `value` string, nullable
    - `includeSubdomains` boolean
    - `protocol` string, nullable
    - `ports` string, nullable

## Changes

- **2026-09-19** `378d74580c23`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hackgate/apis/hackgate-admin-api/changes/api/vpn-connectors/heartbeat/post.md)

---

[API](https://skmtc.dev/hackgate/apis/hackgate-admin-api.md) - [All operations](https://skmtc.dev/hackgate/apis/hackgate-admin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hackgate/apis/hackgate-admin-api/revisions/4001be3c2ed0?raw)