PApapr-ai
v1
Cloud Runtime

Desktop gateway alive ping (defers cloud scheduler when fresh)

Changed on
post/v1/cloud/runtime/heartbeat

Request

  • Base URL
    https://memory.papr.ai
  • URL
    https://memory.papr.ai/v1/cloud/runtime/heartbeat
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer

Request body

external_user_idstring nullable

Parse _User.objectId of the acting user (desktop OAuth). Used for ownership-scoped cloud operations instead of the API key user.

syncProtocolstring nullable

Desktop sync capability version (v2 | v3)

appVersionstring nullable

Desktop gateway semver for straggler tracking

namespaceIdstring nullable

Active namespace from desktop client

syncV3Capabilitiesstring[] nullable

Enabled Sync V3 flags on this desktop build

Response

Successful Response

recordedAtstring required
staleAfterSecondsinteger required
desktopAwakeboolean required

Changes