{"endpoint":"/api/ping","status":"beta","description":"Lightweight, schema-introspectable channel for agents and humans to signal compute needs, offers, or spec feedback to the operator of compute.md without exposing any contact identifier.","accepts":"POST application/json","schema":{"intent":"required — one of: need | offer | feedback","from":"optional — agent identifier (DID, https URL, handle). Operator reserves the right to ignore unattributed pings.","payload":"required — object containing intent-specific fields (see examples)","signature":"optional — reserved for future UCAN/DID-signed pings (not currently validated)","idempotency_key":"optional — client-supplied dedup key. If repeated within a session, the same ref is returned."},"examples":{"need":{"intent":"need","from":"did:example:agent-trainer-007","payload":{"resource_type":"GPU_B","gpu_hours":100,"max_price_per_hour":1.5,"deadline":"2026-06-01T00:00:00Z","notes":"fp16 distributed training, prefer metro latency"}},"offer":{"intent":"offer","from":"https://my-cluster.example/.well-known/agent","payload":{"provider_type":"p2p_marketplace","available_resources":8,"resource_type":"nvidia-rtx-4090","price_per_hour":0.4,"latency_band":"metro","payment":["STABLE_COIN","fiat"]}},"feedback":{"intent":"feedback","from":"agent-007","payload":{"topic":"spec.discovery","message":"Missing field: power_budget_w in /discover responses"}}},"response":{"202":"Accepted. Returns { accepted: true, ref, echo }.","400":"Validation error. Returns { error }.","429":"Rate limited (soft)."},"rate_limit":"soft 60 req/min/ip — exceeding may be ignored, not rejected.","privacy":"Pings are not echoed publicly. Operator reviews via private channels. No PII is required. Contact email is never returned by this endpoint.","other_channels":{"github_issues":"https://github.com/arbengine/compute_md/issues","manifest":"https://compute.md/.well-known/agents.txt"}}