Report a component failure (unenrolled device)

Called by the MineOS device agent when it fails before it holds a device certificate — for example when the installer or
the updater cannot complete; you do not call this endpoint yourself. The agent authenticates with your organization's
enrollment token and describes the failure; it may then upload a diagnostic log to the returned URL. The device identity
it reports is unverified and is used only to help MineOS support investigate.

Responses:

  • 200{ "uploadUrl", "expiresAt", "requiredContentType" }
  • 400{ "error": "invalid_request", "details": [ ... ] }: the request is malformed or contains unknown fields
  • 401{ "reason": "invalid_token" }: the enrollment token is invalid, expired or revoked
  • 413{ "reason": "log_too_large" }
  • 429{ "reason": "quota_exceeded" | "rate_limited", "retryAfter" }
  • 503{ "status": "degraded" }: log storage is temporarily unavailable
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Failure report sent by a device agent component that does not yet hold a device certificate.

string | null

The log identifier, YYYYMMDDTHHMMSSZ-<uuid>, one per run.

int64 | null

The compressed size in bytes of the log to be uploaded. Required; a size over the limit is answered with
413.

string | null

The component reporting the failure: bootstrap (the installer), updater, or scanner.

string | null

Your organization's enrollment token, as embedded in the MDM package.

string | null

What failed, in the component's own vocabulary (for example verify-failed). Required.

string | null

Optional. The step within the outcome that failed (for example signature).

string | null

Optional. The device's platform and architecture (for example darwin-arm64).

string | null

Optional. The reporting component's version (for example 1.3.0).

string | null

Optional. The device id the component believes it has. Unverified; used only to help support correlate reports.

string | null

Optional. The device's hostname as the component sees it. Unverified; used only to help support correlate
reports.

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!