Skip to content

Findings recorded by one sweep run

GET
/admin/storage/sweeps/{id}/findings

Paginated findings for a run (#403), optionally filtered by finding type. Gated on system.storage.read (or system.admin).

Findings are advisory and reflect scan time, not now — anything acting on one must re-verify first.

id
required
string format: uuid
finding
string

Filter by finding type (missing_object / orphan_object / checksum_mismatch / size_mismatch).

limit
integer
default: 50 >= 1 <= 200
offset
integer
0

A page of findings plus the total.

object
items
required
Array<object>
object
id
required
string format: uuid
finding
required
string
Allowed values: missing_object orphan_object checksum_mismatch size_mismatch
object_hash
required
string
variant_key
required
string
detail
required

Human-readable specifics (expected vs actual).

string
detected_at
string format: date-time
nullable
resolved_at
string format: date-time
nullable
total
required
integer format: int64

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed