---
title: "Agent heartbeat"
method: POST
path: "/v1/agent/ping"
tags: ["Agent Infrastructure"]
---

# Agent heartbeat

`POST /v1/agent/ping`

Signal alive status. Updates last_seen. Returns uptime info.

## Response `200`

Pong with uptime info

- object
  - `pong` boolean
  - `did` string
  - `status` string
  - `uptime` object
  - `server_time` string, date-time

## Other responses

- `401` — Invalid or missing X-Agent-Key header

---

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