v1.2

Release: Bear Robot API v1.2

March 6, 2026

Release

Prod

servi-26.01

carti-26.01

amr-26.01

Breaking changes

Note

The v1 API is a new surface published alongside the existing v0.1 API.

The v0.1 API remains supported.

Note

This version jumps to v1.2 to indicate that it corresponds with Bear Cloud API v1.2.

Future releases will continue this convention.

Minimum Robot Software Versions (for full support)

1. Servi: 26.01
2. Carti: 26.01
3. AMR: 26.01

Breaking Changes

Bear Robot API v1.2 is not backward compatible with v0.1. To use the v1.2 API, users must download and compile the new v1.2 Protobuf library. Refer to the functional comparison table below and follow the Upgrade Guide. Contact Customer Support or your Account Manager if additional help is needed.

New RPCs

Mission

• CreateMission
• CreateMissionWorkflow
• AppendMission
• ChargeRobot
• SkipGoal
• UpdateMission
• SubscribeMissionStatus

Robot Status

• GetRobotStatus
• SubscribeRobotStatus
• SubscribeErrorCodes

Robot System

• RunSystemCommand

Settings

• GetSettings
• GetAllSettings
• SetSetting
• ResetSettings

Servi

• CalibrateTrays

Carti

• GetConveyorIndex
• SubscribeConveyorStatus
• ControlConveyor

New API Customers

Please contact your Account Manager to discuss API use cases and request API keys.

How to Upgrade

1. Review the v1.2 API endpoint specification.
2. Upgrade robot software to the compatible versions listed above.
3. Download and compile the updated v1 Protobuf library. See our Programming Guide and examples for relevant endpoints.
4. Test your integration against the new version.

API Functionality Comparison: Beta v0.1 vs. Prod v1.2

v0.1	v1.2 Prod	What's Changed
CreateMission	CreateMission	Mission behavior now indicated by message type per robot family, e.g. DeliveryMission (Servi) and TraverseMission (Carti)
UpdateMission	UpdateMission	Same as above, follows the mission type model
AppendMission	AppendMission	Same functionality; updated to new Protobuf library
ChargeRobot	ChargeRobot	Same functionality; updated to new Protobuf library
SubscribeMissionStatus	SubscribeMissionStatus	Updated mission state model aligned with the mission type model
SubscribeBatteryStatus	SubscribeRobotStatus	Battery state consolidated into RobotState; also available on demand via GetRobotStatus
SubscribeEmergencyStopStatus	SubscribeRobotStatus	Emergency stop state consolidated into RobotState
SubscribeRobotPose	SubscribeRobotStatus	Robot pose consolidated into RobotState
SubscribeOdometryStatus	SubscribeRobotStatus	Pose and velocity (twist) consolidated into RobotState
SetSetting	SetSetting	New schema-based settings model; settings can also be restored via ResetSettings
SubscribeSettings	GetSettings	Settings stream replaced by on-demand reads; see also GetAllSettings
RunSystemCommand	RunSystemCommand	Same functionality; updated to new Protobuf library
GetLocation	n/a	Not available in v1.2; continue to use v0.1 if needed
GetMapContent	n/a	Not available in v1.2; continue to use v0.1 if needed
SwitchMap	n/a	Not available in v1.2; continue to use v0.1 if needed
DriveRobot	n/a	Not available in v1.2; continue to use v0.1 if needed
LocalizeRobot	n/a	Not available in v1.2; continue to use v0.1 if needed
SetEmergencyStop	n/a	Not available in v1.2; continue to use v0.1 if needed
SetPose	n/a	Not available in v1.2; continue to use v0.1 if needed
SubscribeLocalizationStatus	n/a	Not available in v1.2; continue to use v0.1 if needed
SubscribeOperationStatus	n/a	Not available in v1.2; continue to use v0.1 if needed
ConnectWifi	n/a	Not available in v1.2; continue to use v0.1 if needed
ForgetWifi	n/a	Not available in v1.2; continue to use v0.1 if needed
ListWifiConnections	n/a	Not available in v1.2; continue to use v0.1 if needed
SubscribeNetworkStatus	n/a	Not available in v1.2; continue to use v0.1 if needed
GetSystemInfo	n/a	Not available in v1.2; continue to use v0.1 if needed