Skip to content

v1.2

Release: Bear Cloud API v1.2

March 6, 2026

Release
Prod
servi-26.01
carti-26.01

Note

Bear Cloud API v1.2 is designed to be backward compatible with v1.1, so there should not be any issues working with the v1.1 gRPC APIs.

Minimum Robot Software Versions (for full support)

  1. Servi: 26.01
  2. Carti: 26.01

Key features

  • 2 new RPCs for mission workflow management and goal control
  • Enhanced robot status monitoring with velocity tracking through the new twist field
  • Improved system control with shutdown capability for robots
  • Better map support with workstation type destination support in map retrieval RPCs

New RPCs

Mission

  • CreateMissionWorkflow - Create a mission workflow that mirrors touchscreen presets (e.g., automatic return point selection). Supports Servi workflows and Carti workflows
  • SkipGoal - Advance the current mission to the next goal, skipping the current one

Modified Message Fields

RobotState (bearrobotics/api/v1/core/robot_status.proto)

  • Added: twist field (field 9) - Current linear and angular velocity of the robot. Omitted when not reported by the robot
  • New: Twist message - Represents the current velocity of the robot in 2D (linear along the forward axis, angular around the vertical axis)

SystemCommand (bearrobotics/api/v1/core/robot_system.proto)

  • Added: shutdown field (field 2) - Shut down the robot system
  • New: Shutdown message - Empty message type for shutting down the robot system

Bug Fixes

Maps & Locations

  • Support for workstation type destination in Map retrieval RPCs - GetMap and GetCurrentMap now properly support workstation type destinations in their responses

Mission Handling

  • Navigate type missions blocked in robot side validator layer - Fixed an issue where Navigate type missions were incorrectly blocked by the robot-side validator. This was a robot software issue that has been resolved in version 26.01

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.