Skip to main content
POST
curl (Linux)

Authorizations

Authorization
string
header
required

The token from the agent's discovery file (%ProgramData%\Miru\device-api\device-api.json on Windows). Required over loopback TCP (127.0.0.1:6478 by default on Windows) and accepted by every route; not used over the Unix socket.

Body

application/json
component
string
required

Slug of the component whose latest calibration to invalidate, such as kuka-arm.

Example:

"kuka-arm"

reason
string
required

Why the calibration is no longer valid, such as power cycle. Free text, at most 512 characters, and not blank.

Required string length: 1 - 512
Example:

"power cycle"

report_id
string<uuid>

Report ID of the calibration the caller expects to be component's latest. If it is not component's current latest calibration, the agent invalidates nothing. Leave it out to invalidate whatever is latest.

Example:

"0b6f3c2e-6a51-4e0f-9a43-2f1d7c9e8b10"

Response

200 - application/json

The agent marked the calibration invalid and will upload the invalidation to Miru. If the calibration is already invalid, the agent returns it unchanged.

The newest calibration the device has for one component.

object
enum<string>
required

The object type, which is always calibration.

Available options:
calibration
Example:

"calibration"

report_id
string<uuid>
required

ID the agent gave the report this calibration came from. Download the content with it.

Example:

"0b6f3c2e-6a51-4e0f-9a43-2f1d7c9e8b10"

component
string
required

Slug of the component the calibrated unit belongs to.

Example:

"kuka-arm"

serial_number
string | null
required

Serial number of the physical unit that was calibrated, not of the device, such as SN-1234, or null if none was reported. Free text, at most 255 characters.

Maximum string length: 255
Example:

"SN-1234"

reported_by
string | null
required

Who reported the calibration, as it was reported, such as Benjamin Smidt; null if no one was reported.

Maximum string length: 255
Example:

"Benjamin Smidt"

reported_at
string<date-time>
required

Timestamp of when the agent received the calibration.

Example:

"2026-03-10T12:00:00Z"

invalidated_at
string<date-time> | null
required

Timestamp of when a device app marked this calibration invalid, or null if it is valid. A newer calibration for the component replaces it.

Example:

"2026-03-11T08:00:00Z"