POST
/
api
/
v1
/
agent_heartbeat
{
  "status": "ok"
}
Updates the agent’s last_seen timestamp to track agent activity. This endpoint is intended for agent self-reporting and requires agent token authentication.
Requires Agent token authentication (not user token)
The agent ID is automatically extracted from the agent token.

​
Example

curl -X POST "https://api.garnet.ai/v1/agent_heartbeat" \
  -H "Authorization: Bearer $AGENT_TOKEN"

​
Response

​
status
string
Status of the heartbeat update (typically “ok”)
{
  "status": "ok"
}

​
Error Examples

{
  "error": "Invalid or missing agent token",
  "type": "UnauthorizedAgent"
}

{
  "error": "Agent not found"
}