Beta module namespace
inventory
Beta routes may change with notice and are NOT covered by the 24-month stable window of the core contract.
Every module route is enumerated with method, path, auth and required permission; request/response schemas are not published for the beta surface.
5 operations
| Method | Path | Required permission | Authentication | Summary |
|---|---|---|---|---|
| get | /v1/m/inventory/collections | inventory:catalog:read | Bearer token | Returns the collection coverage of one opened source registration, selected by ?source_id, ?source_revision and ?environment_ref: the current run's result, and the last qualified run when its scope has one. |
| get | /v1/m/inventory/entities | inventory:catalog:read | Bearer token | Lists catalog entries, optionally filtered by kind and status, paginated by the default id keyset cursor. |
| get | /v1/m/inventory/entities/{kind}/{id} | inventory:catalog:read | Bearer token | Returns one catalog entry plus a minimal projection of the core entity it overlays. |
| get | /v1/m/inventory/entities/{kind}/{id}/observations | inventory:catalog:read | Bearer token | Lists the stored observation receipts that name one catalog entity, one item per distinct receipt in ascending receipt order, in pages of at most 25 (?limit 1..25, ?cursor from the previous page): each item carries the receipt id, the event type, the registration snapshot recorded at reception (historical, not the source's current registration or health), the source-declared occurrence instant when declared, first and last reception of the same retained facts, the equal-facts delivery count and whether a conflicting redelivery is retained; names, references, labels, raw facts, hashes and event ids are withheld, a missing catalog entry is 404, and an empty page does not prove no observation. |
| get | /v1/m/inventory/summary | inventory:catalog:read | Bearer token | Returns the estate overview: counts by entity kind and by signal source. |