PingResultRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/agentry-com/json-schema/agentry-com-ping-result-request-schema.json",
  "title": "PingResultRequest",
  "description": "Payload submitted by a monitor to record a single uptime check.",
  "x-generated": "2026-10-29",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/agentry-com-openapi.json#/components/schemas/PingResultRequest",
  "properties": {
    "status": {
      "type": "string",
      "title": "Status",
      "description": "Result of the check: 'up' if the agent responded successfully, 'down' otherwise."
    },
    "latency_ms": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0.0
        },
        {
          "type": "null"
        }
      ],
      "title": "Latency Ms",
      "description": "Round-trip latency in milliseconds. Should be omitted or null when status is 'down' and no connection could be established."
    },
    "checked_by": {
      "type": "string",
      "title": "Checked By",
      "description": "Identifier of the entity performing the check — 'system' for the platform monitor, or an agent_id for peer-to-peer health checks.",
      "default": "system"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Error",
      "description": "Error message if status is 'down', e.g., timeout, connection refused."
    },
    "endpoint": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Endpoint",
      "description": "Specific endpoint or URL that was probed, if relevant."
    }
  },
  "type": "object",
  "required": [
    "status"
  ]
}