> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mirurobotics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Invalidate Latest

> Mark a component's latest calibration invalid.



## OpenAPI

````yaml /references/device-api/v0.3.0/api.yaml post /calibrations/latest/invalidate
openapi: 3.0.3
info:
  title: Miru Agent API
  description: >-
    The API between the Miru Agent and any external client living on the same
    device as the Miru Agent. On Linux the agent serves it over the Unix socket
    `/run/miru/miru.sock` with no authentication. Over loopback TCP, which is on
    by default on Windows at `127.0.0.1:6478`, every route requires
    `Authorization: Bearer <token>`. Clients read the port and token from the
    agent's discovery file, `%ProgramData%\Miru\device-api\device-api.json` on
    Windows; the token changes every time the agent starts.
  version: v0.3
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  x-release-version: v0.3.0
  x-git-commit:
    sha: 13ce9431f6c8183218bb62bcfe1d025852c08de6
    url: >-
      https://github.com/mirurobotics/openapi/commit/13ce9431f6c8183218bb62bcfe1d025852c08de6
    message: 'chore(device): bump the Device API version (#518)'
    author: Ben's Agent
    branch: HEAD
    dirty: false
  x-build:
    built_at: '2026-11-17T04:03:13.976979+00:00'
servers:
  - url: http://localhost/v0.3
    description: localhost
security:
  - {}
  - BearerAuth: []
paths:
  /calibrations/latest/invalidate:
    post:
      tags:
        - Calibrations
      summary: Invalidate Latest
      description: Mark a component's latest calibration invalid.
      operationId: invalidateLatestCalibration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InvalidateCalibrationRequest'
      responses:
        '200':
          description: >-
            The agent marked the calibration invalid and will upload the
            invalidation to Miru. If the calibration is already invalid, the
            agent returns it unchanged.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Calibration'
      x-codeSamples:
        - lang: curl
          label: curl (Linux)
          source: |-
            curl \
              --unix-socket /run/miru/miru.sock \
              --request POST \
              --url http://localhost/v0.3/calibrations/latest/invalidate \
              --header 'Content-Type: application/json' \
              --data '{"component": "kuka-arm", "report_id": "0b6f3c2e-6a51-4e0f-9a43-2f1d7c9e8b10", "reason": "power cycle"}'
        - lang: powershell
          label: PowerShell (Windows)
          source: >-
            $api = Get-Content -Raw
            "$env:ProgramData\Miru\device-api\device-api.json" |
            ConvertFrom-Json; `

            $body = @{ component = "kuka-arm"; report_id =
            "0b6f3c2e-6a51-4e0f-9a43-2f1d7c9e8b10"; reason = "power cycle" } |
            ConvertTo-Json; `

            Invoke-RestMethod -Method Post `
              -Uri "http://127.0.0.1:$($api.port)/v0.3/calibrations/latest/invalidate" `
              -Headers @{ Authorization = "Bearer $($api.token)" } `
              -ContentType "application/json" `
              -Body $body
components:
  schemas:
    InvalidateCalibrationRequest:
      title: Invalidate Calibration Request
      type: object
      required:
        - component
        - reason
      properties:
        component:
          type: string
          example: kuka-arm
          description: >-
            Slug of the component whose latest calibration to invalidate, such
            as `kuka-arm`.
        report_id:
          type: string
          format: uuid
          example: 0b6f3c2e-6a51-4e0f-9a43-2f1d7c9e8b10
          description: >-
            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.
        reason:
          type: string
          minLength: 1
          maxLength: 512
          example: power cycle
          description: >-
            Why the calibration is no longer valid, such as `power cycle`. Free
            text, at most 512 characters, and not blank.
    Calibration:
      title: Calibration
      type: object
      description: The newest calibration the device has for one component.
      required:
        - object
        - report_id
        - component
        - serial_number
        - reported_by
        - reported_at
        - invalidated_at
      properties:
        object:
          type: string
          enum:
            - calibration
          example: calibration
          x-stainless-const: true
          description: The object type, which is always `calibration`.
        report_id:
          type: string
          format: uuid
          example: 0b6f3c2e-6a51-4e0f-9a43-2f1d7c9e8b10
          description: >-
            ID the agent gave the report this calibration came from. Download
            the content with it.
        component:
          type: string
          example: kuka-arm
          description: Slug of the component the calibrated unit belongs to.
        serial_number:
          type: string
          nullable: true
          maxLength: 255
          example: SN-1234
          description: >-
            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.
        reported_by:
          type: string
          nullable: true
          maxLength: 255
          example: Benjamin Smidt
          description: >-
            Who reported the calibration, as it was reported, such as `Benjamin
            Smidt`; null if no one was reported.
        reported_at:
          type: string
          format: date-time
          example: '2026-03-10T12:00:00Z'
          description: Timestamp of when the agent received the calibration.
        invalidated_at:
          type: string
          format: date-time
          nullable: true
          example: '2026-03-11T08:00:00Z'
          description: >-
            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:
        object: calibration
        report_id: 0b6f3c2e-6a51-4e0f-9a43-2f1d7c9e8b10
        component: kuka-arm
        serial_number: SN-1234
        reported_by: Benjamin Smidt
        reported_at: '2026-03-10T12:00:00Z'
        invalidated_at: null
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        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.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.