---
title: "Sync"
method: POST
path: "/robots/controller"
tags: ["robots"]
---

# Sync

`POST /robots/controller`

## Request

- Base URL: `https://api.os3robotics.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.os3robotics.com/robots/controller`
- Auth: HTTP bearer

## Request body

- ControllerSync
  - `commit` string, required
  - `failed` Failure
    - `rollout_id` string, uuid, required
    - `commit` string, required
    - `reason` string, required
  - `claims` ClaimAnswer[]
    - `intervention_id` string, uuid, required
    - `status` 'owner' | 'refused', required
    - `reason` string, nullable
  - `calibration_sha256` string, nullable
  - `identity` RuntimeIdentity: What the robot runs: its action space, wire contract, cameras and controller API, as its handshake record states them.
    - `action_space_id` string
    - `wire_contract_version` string
    - `camera_shapes` object, required
    - `controller_api_version` string, required

## Response `200`

Successful Response

- Desired
  - `rollout_id` string, uuid, nullable
  - `commit` string, nullable
  - `source` string, nullable
  - `version` string, nullable
  - `rollback` boolean
  - `endpoint_id` string, uuid, nullable
  - `pending_endpoint_id` string, uuid, nullable
  - `claims` Claim[]
    - `intervention_id` string, uuid, required
    - `episode_id` string, required
    - `operator_id` string, required
    - `claimed_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/os3robotics/apis/os3-api.md) - [All operations](https://skmtc.dev/os3robotics/apis/os3-api/llms.txt) - [OpenAPI document](https://skmtc.dev/os3robotics/apis/os3-api/revisions/af32cd4f14bb?raw)