---
title: "Indicates that a Link Server has sent a heartbeat"
method: PATCH
path: "/link/servers/{id}/heartbeat"
tags: ["LinkServer"]
---

# Indicates that a Link Server has sent a heartbeat

`PATCH /link/servers/{id}/heartbeat`

## Path parameters

- `id` string, required

## Request body

- LinkServer
  - `id` string
  - `created_time` integer — Time at which the Link Server was created
  - `last_heartbeat_time` integer — Time at which the Link Server last sent a heartbeat
  - `label` string — The label associated with this Link Server
  - `version` string — The version of the Link Server software that this instance is running
  - `status` 'starting' | 'running' — The current status of this Link Server
  - `tunnel_client_connections` integer — The number of active tunnel client connections to this Link Server
  - `forwarding_client_connections` integer — The number of active forwarding client connections to this Link Server
  - `tunnel_host` string — The public Link Server host (hostname or IP address)
  - `tunnel_port` integer — The public Link Server port
  - `forwarding_host` string — The forwarding host (hostname or IP address)
  - `forwarding_port` integer — The forwarding port
  - `workspace_id` string — The workspace ID associated with this Link Server
  - `container_id` string — ID of the container where this Link Server is running
  - `size` 'small' | 'large' — The size of the Link Server, which determines its resource allocation

## Response `204`

Heartbeat acknowledged

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `404` — Link Server not found
- `412` — If-Match precondition not satisfied
- `default` — Unknown error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)