---
title: "Post Heartbeat"
method: POST
path: "/api/v1/workflow/agent/heartbeat"
tags: ["WORKFLOW_AGENT"]
---

# Post Heartbeat

`POST /api/v1/workflow/agent/heartbeat`

Agent posts health ping. Returns pending commands.

## Request body

- HeartbeatRequest
  - `instance_id` string, required
  - `status` string
  - `vitals` object, nullable
  - `llm_usage` object, nullable
  - `capacity` object, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

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