---
title: "Agent Heartbeat"
method: POST
path: "/agents/{agent_id}/heartbeat"
---

# Agent Heartbeat

`POST /agents/{agent_id}/heartbeat`

Register an agent heartbeat.

## Path parameters

- `agent_id` string, required

## Request body

- HeartbeatRequest — Body for POST /agents/{agent_id}/heartbeat.
  - `role` string
  - `status` 'starting' | 'working' | 'idle' | 'dead'

## Response `200`

Successful Response

- HeartbeatResponse — Response for heartbeat.
  - `agent_id` string, required
  - `acknowledged` boolean, required
  - `server_ts` number, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/sipyourdrink-ltd/apis/bernstein-task-server.md) · [All operations](https://skmtc.net/sipyourdrink-ltd/apis/bernstein-task-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sipyourdrink-ltd/bernstein-task-server/versions/86f514b4e920/schema)