GoodMemGoodMem
ReferenceAPIREST APIPing

Stream ping probe results

Opens a streaming ping session and returns per-probe results plus a terminal summary. Supports SSE (text/event-stream) and NDJSON (application/x-ndjson) formats.

POST
/v1/ping:stream

Header Parameters

Accept?string

Response format: 'text/event-stream' for Server-Sent Events or 'application/x-ndjson' for newline-delimited JSON

Ping stream configuration

targetIdstring

Target resource ID (UUID)

Example"550e8400-e29b-41d4-a716-446655440000"
Formatuuid
targetTypeHint?PingTargetType | null

Optional hint for the target resource type

Example"EMBEDDER"
count?integer | null

Number of probes to run (0 uses server default)

Default4
Formatint32
Range0 <= value
intervalMs?integer | null

Delay between probes in milliseconds (0 uses server default)

Default1000
Formatint32
Range0 <= value
timeoutMs?integer | null

Per-probe timeout in milliseconds (0 uses server default)

Default5000
Formatint32
Range0 <= value
payloadType?PingPayloadType | null

Desired payload type (defaults to provider-specific value)

Example"TEXT"
payload?string | null

Explicit UTF-8 payload to send with each probe (mutually exclusive with payloadSizeBytes)

Example"ping"
payloadSizeBytes?integer | null

Synthetic payload size in bytes (mutually exclusive with payload)

Example64
Formatint32
Range0 <= value
maxInFlight?integer | null

Maximum concurrent probes (defaults to 1)

Default1
Formatint32
Range1 <= value
jitter?boolean | null

Add jitter to probe scheduling

Examplefalse
labels?object | null

Optional labels to attach to the ping session

Example{"origin":"console"}
Propertiesproperties <= 20

Empty Object

Response Body

curl -X POST "https://loading/v1/ping:stream" \  -H "Accept: application/x-ndjson" \  -H "Content-Type: application/json" \  -d '{    "targetId": "550e8400-e29b-41d4-a716-446655440000"  }'
{
  "result": null,
  "summary": {
    "endpoint": {
      "targetType": "EMBEDDER",
      "targetId": "550e8400-e29b-41d4-a716-446655440000",
      "resolvedEndpoint": "https://api.openai.com/v1/embeddings",
      "provider": "OPENAI",
      "modelIdentifier": "text-embedding-3-small"
    },
    "requests": 4,
    "responses": 4,
    "ok": 3,
    "timeouts": 1,
    "errors": 0,
    "rttMinMs": 98.2,
    "rttAvgMs": 110.5,
    "rttP50Ms": 105.3,
    "rttP90Ms": 130.7,
    "rttP99Ms": 145.9,
    "rttMaxMs": 150.2,
    "requestsPerSecond": 3.9,
    "bytesPerSecond": 512,
    "appliedLimits": {
      "max_count": "20"
    }
  },
  "notice": {
    "code": "COUNT_CLAMPED",
    "message": "Probe count reduced to maximum allowed value",
    "details": {
      "requested": "100",
      "applied": "20"
    }
  }
}
Empty
Empty
Empty
Empty
Empty
Empty
Empty