Get a report upload URL

Called by the MineOS device agent after each scan to upload its report; you do not call this endpoint yourself. The agent
authenticates with its device certificate, declares the report id, and receives a short-lived URL to upload the report to.
The same call carries the device's health check-in (last run outcome, scheduled slot, agent version), which is what the
device status endpoints show.

Responses:

  • 200{ "uploadUrl", "expiresAt", "requiredContentType" }: upload the report with an HTTP PUT to uploadUrl
    before expiresAt
  • 400{ "error": "invalid_request", "details": [ ... ] }: the request is malformed or contains unknown fields
  • 403{ "reason": "enrollment_not_active" }: the device is not (or no longer) an approved device
  • 429{ "reason": "quota_exceeded" | "rate_limited", "retryAfter" }: the device's daily report quota or your
    organization's rate limit is reached
  • 503{ "status": "degraded" }: report storage is temporarily unavailable; the agent retries
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Report upload request sent by the device agent: the report id plus the device's health check-in.

string | null

The report identifier, YYYYMMDDTHHMMSSZ-<uuid>. Repeating a report id returns a URL for the same
report.

string | null

Optional. The outcome of the agent's last run, as the agent reports it.

string | null

Optional. Whether the agent's local cache passed its integrity check on the last run.

string | null

Optional. When the last run happened, by the device's clock (ISO 8601, UTC).

string | null

Optional. The daily scan time the device's scheduler is confirmed to run, in device-local HH:MM.

string | null

Optional. A scan time that has been assigned but not yet applied on the device: HH:MM or unknown.

string | null

Optional. How many scheduled runs the pending scan time has been waiting, as a string.

string | null

Optional. The version of the agent that is running.

Headers
string
enum
Defaults to application/json-patch+json

Generated from available request content types

Allowed:
Response
200

Success

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here!