Skip to content

Latest measurements ​

5 endpoints at a glance
MethodPathSummary
GET/admin/measurements-latest/Latest Summary
POST/admin/measurements-latest/discoverRun Discover
POST/admin/measurements-latest/recoverRecover Stale
POST/admin/measurements-latest/refreshForce Refresh
GET/admin/measurements-latest/rowsList Rows

measurements-latest​


Latest Summary​

GET
/admin/measurements-latest/

Ledger rollup + worker snapshot. Drives the admin panel header.

Parameters​

Header Parameters

authorization
x-api-key

Responses​

Successful Response

application/json
JSON
{
  
"additionalProperties": "string"
}

Playground​

Headers

Samples​


List Rows​

GET
/admin/measurements-latest/rows

Paginated ledger rows. Optional status filter (pending /
running / done / failed / dead).

Parameters​

Header Parameters

authorization
x-api-key

Query Parameters

status
limit
Type
integer
Default
100
skip
Type
integer
Default
0

Responses​

Successful Response

application/json
JSON
{
  
"additionalProperties": "string"
}

Playground​

Headers
Variables
Key
Value

Samples​


Force Refresh​

POST
/admin/measurements-latest/refresh

Make matching ledger rows due now (manual retry / unstick).

Parameters​

Header Parameters

authorization
x-api-key

Request Body​

application/json
JSON
{
  
"msm_id": 0,
  
"status": "string"
}

Responses​

Successful Response

application/json
JSON
{
  
"additionalProperties": "string"
}

Playground​

Headers
Body

Samples​


Run Discover​

POST
/admin/measurements-latest/discover

Trigger the discovery scan now (out-of-cycle). Idempotent —
only finds terminal+uncached measurements not already in the
ledger. Wrapped in asyncio.to_thread because the underlying
scan is blocking (Mongo aggregate + per-id $setOnInsert).

Parameters​

Header Parameters

authorization
x-api-key

Responses​

Successful Response

application/json
JSON
{
  
"additionalProperties": "string"
}

Playground​

Headers

Samples​


Recover Stale​

POST
/admin/measurements-latest/recover

Flip rows stuck in running past the stale deadline back to
pending + due-now and re-enqueue them on the worker. Same
cooperative contract as the workers-panel "Recover stale" action
but scoped only to this ledger.

Parameters​

Header Parameters

authorization
x-api-key

Responses​

Successful Response

application/json
JSON
{
  
"additionalProperties": "string"
}

Playground​

Headers

Samples​


Atlas — built on RIPE Atlas data.