Post Heartbeat

Ping periódico desde la app. Actualiza last_seen_at en la licencia y guarda en heartbeats.

lmcp-api#274 (colibird-ai/.github#189) — pacing contract with the clients:

  • the response carries an integer next_beat_s: how long the client should wait before its next liveness ping. Default 900 (HEARTBEAT_FLOOR_S), LMCP_HEARTBEAT_NEXT_BEAT_S overrides it, always inside [300, 3600]. A client that does not know the field ignores it and keeps beating every 5 minutes, which every reader still supports.
  • a beat that changed the state fingerprint or carries work (tool calls, errors, slow calls, journeys) is stored as a heartbeats row; a pure liveness ping only refreshes machines and the hourly liveness counter. A client sends at once when its state or batch changes, and otherwise on next_beat_s (15 minutes floor).
post/heartbeat

Request

  • Base URL: https://api.local-mcp.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.local-mcp.com/heartbeat
  • Auth: none declared

Request body

license_keystring
cloud_tokenstring
license_emailstring
machine_idstring
versionstring
running_versionstring
npm_versionstring
os_versionstring
os_buildunknown
surface_v2_fallbackunknown
qa_modeunknown
qa_grant_refusedunknown
uptime_hrsnumber
transportstring
tool_callsinteger
tool_breakdownobject
tray_versionstring
machine_labelstring nullable
archstring
refstring
ai_clientstring
localestring
mem_available_mbinteger nullable
cpu_ms_totalinteger nullable
rss_mbinteger nullable
mail_index_statestring nullable
mail_index_totalinteger nullable
mail_index_pendinginteger nullable
mail_index_tick_msinteger nullable
mail_index_walk_msinteger nullable
mail_index_db_mbinteger nullable
rss_peak_mbinteger nullable
mail_index_rss_delta_mbinteger nullable
web_sessions_openinteger nullable
web_sessions_oldest_mininteger nullable
session_countinteger nullable
feature_flagsobject
read_onlyboolean
disabled_tools_countinteger
account_permission_countsunknown
mcp_pausedboolean
ai_clients_stateobject nullable
tools_ever_listedboolean
mcp_clientstring
pidinteger
started_atstring
tcc_statusobject
tray_process_countinteger nullable
servicesobject
tool_errorsobject
tool_error_samplesobject
slow_tool_callsobject
cpu_pctnumber
large_responsesobject
empty_resultsobject
terminal_usageunknown
manifest_versionstring
m365_statusstring
server_sourcestring
tray_bundle_locationstring
originunknown
launch_pathunknown
connectionsunknown

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.