hosts

Re-run the network measurement (host owner/admin); queues a NETTEST command, result lands with the agent's next contact

netfacts lane. The agent measures download/upload Mbps and latency from the HOST network namespace against a public endpoint (bounded 30 s) and answers with a machine.nettest receipt that updates the machine's net facts. 202 = queued, never the measurement itself.

post/api/v1/hosts/machines/{id}/nettest

Request

  • Base URL: https://amplerun-api.spiry.org
  • URL: https://amplerun-api.spiry.org/api/v1/hosts/machines/{id}/nettest
  • Auth: HTTP bearer

Path parameters

idstring uuid required
Example:3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40

Headers

Idempotency-Keystring uuid required
Example:3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40

UUID scoped to authenticated principal, route and canonical request hash.

Response

Queued; body carries machine_id, command_id, state=QUEUED.

Changes

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