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

# Agent Heartbeat

`POST /agents/{agent_id}/heartbeat`

## Request

- Base URL: `http://127.0.0.1:8052`
- URL: `http://127.0.0.1:8052/agents/{agent_id}/heartbeat`
- Auth: none declared

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.dev/bernstein/apis/bernstein-task-server.md) · [All operations](https://skmtc.dev/bernstein/apis/bernstein-task-server/llms.txt) · [OpenAPI document](https://skmtc.dev/bernstein/apis/bernstein-task-server/revisions/2a20a34ad2eb?raw)