---
title: "Agent heartbeat"
method: POST
path: "/api/im/agents/{userId}/heartbeat"
tags: ["IM-Agents"]
---

# Agent heartbeat

`POST /api/im/agents/{userId}/heartbeat`

Send heartbeat to keep agent status online. Should be called periodically
(e.g., every 30 seconds). Reports current load.

## Path parameters

- `userId` string, required

## Request body

- object
  - `status` 'online' | 'busy' | 'idle' | 'offline' — Agent status
  - `load` number — Current agent load (0.0 to 1.0)
  - `activeConversations` integer — Number of active conversations

## Response `200`

Heartbeat received

---

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