{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"8e12a638-445e-4a8d-ba11-23d9544d65ec","name":"Bear Robotics Public REST API v1.3","description":"Postman collection for Bear Robotics Public REST API v1.3. This collection includes all unary (non-streaming) endpoints defined in the BearAPI v1.3 service.\n\n### API Version Information\n\n- **API Version**: v1.3\n    \n- **Endpoints**: 23 endpoints (7 endpoints from v1.0 + 11 additional endpoints in v1.1 + 2 additional endpoints in v1.2 + 3 additional endpoints in v1.3)\n    \n\nBear Cloud API v1.3 is designed to be **backward compatible** with v1.2, v1.1, and v1.0. However, some endpoints require specific robot software versions (Servi 26.02, Carti 26.02, AMR 26.02 for full support).\n\n### v1.3 Changes\n\n**New Endpoints (3):**\n\n- `CreateMissionBatch` - Atomically create multiple missions in a single request\n    \n- `AppendMissionBatch` - Atomically append multiple missions to the end of the mission queue\n    \n- `ClearMissionStatus` - Clear the robot's mission status\n    \n\n**Updated Endpoints:**\n\n- `GetRobotStatus` - Added `navigation_state` field (carries the robot's stuck state)\n    \n- `GetMap` - Added `md5_checksum` field in `MapImageFileInfo` for integrity verification (CRC32C `checksum` is deprecated)\n    \n\n**Streaming RPCs (not included in this collection):** `SubscribeNavigationStatus`, `SubscribeOnlineStatus`, and the now fleet-capable `SubscribeEmergencyStopStatus` are streaming endpoints and are documented in the API reference rather than this REST collection.\n\n### Overview\n\nThis collection provides a comprehensive set of endpoints for interacting with Bear Robotics robots via REST API v1.3. It covers:\n\n- **Mission Commands**: Create, append, update, and manage robot missions (includes v1.3 additions: CreateMissionBatch, AppendMissionBatch, ClearMissionStatus)\n    \n- **Maps & Locations**: Retrieve maps, locations, and destination information\n    \n- **Localization & Navigation**: Control robot positioning and navigation\n    \n- **Robot Status**: Monitor robot connectivity and operational states (includes v1.3 addition: navigation_state on GetRobotStatus)\n    \n- **Robot System**: System information and OS-level commands\n    \n- **Fleet Management**: Manage multiple robots and locations\n    \n- **Servi-Specific Extensions**: Tray calibration for Servi robots\n    \n- **Carti-Specific Extensions**: Conveyor control for Carti robots\n    \n\n### Included Endpoints\n\n**v1.0 endpoints (7 endpoints):**\n\n- `/v1/mission/append` - AppendMission\n    \n- `/v1/mission/create` - CreateMission\n    \n- `/v1/mission/update` - UpdateMission\n    \n- `/v1/robot/charge` - ChargeRobot\n    \n- `/v1/current-map/get` - GetCurrentMap\n    \n- `/v1/robot/localize` - LocalizeRobot\n    \n- `/v1/robot-ids/list` - ListRobotIDs\n    \n\n**v1.1 additional endpoints (11 endpoints):**\n\n- `/v1/location-info/get` - GetLocationInfo\n    \n- `/v1/map/get` - GetMap\n    \n- `/v1/map/switch` - SwitchMap\n    \n- `/v1/pose/set` - SetPose\n    \n- `/v1/robot-state/get` - GetRobotStatus\n    \n- `/v0/robot-system-info/get` - GetRobotSystemInfo\n    \n- `/v1/system-command/run` - RunSystemCommand\n    \n- `/v1/available-locations/get` - GetAvailableLocations\n    \n- `/v1/trays/calibrate` - CalibrateTrays\n    \n- `/v1/conveyor-index/get` - GetConveyorIndex\n    \n- `/v1/conveyor/control` - ControlConveyor\n    \n\n**v1.2 additional endpoints (2 endpoints):**\n\n- `/v1/mission-workflow/create` - CreateMissionWorkflow\n    \n- `/v1/goal/skip` - SkipGoal\n    \n\n**v1.3 additional endpoints (3 endpoints):**\n\n- `/v1/mission/create-batch` - CreateMissionBatch\n    \n- `/v1/mission/append-batch` - AppendMissionBatch\n    \n- `/v1/mission-status/clear` - ClearMissionStatus\n    \n\n### Important Setup\n\n**Required Collection Variables:**\n\n- `base_url`: API Base URL (e.g., [https://api.bearrobotics.ai](https://api.bearrobotics.ai))\n    \n- `auth_url`: Authentication server URL (e.g., [https://api-auth.bearrobotics.ai](https://api-auth.bearrobotics.ai))\n    \n- `robot_id`: Robot ID to use for API requests\n    \n\n**Authentication Variables:**\n\n- **API Key Method**: `api_key`, `api_secret`, `scope`\n    \n\n### Getting Started\n\n1. Set the required Collection Variables in the Collection Variables tab\n    \n2. Call the authentication endpoint to obtain a JWT token (token is automatically saved to `bearer_token`)\n    \n3. Use the `bearer_token` in subsequent API requests\n    \n\n### Documentation\n\nFor detailed API documentation, refer to the Bear Robotics API documentation:\n\n- Public API Documentation: [https://cloud.api.bearrobotics.ai/](https://cloud.api.bearrobotics.ai/)","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"44195110","team":6400800,"collectionId":"8e12a638-445e-4a8d-ba11-23d9544d65ec","publishedId":"2sBXwto8ex","public":true,"publicUrl":"https://documenter-api.postman.tech/view/44195110/2sBXwto8ex","privateUrl":"https://go.postman.co/documentation/44195110-8e12a638-445e-4a8d-ba11-23d9544d65ec","customColor":{"top-bar":"D7F2FF","right-sidebar":"001D51","highlight":"15B7FF"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"Official Postman collection for the Bear Robotics Public REST API v1.3, including authentication, endpoints, request formats, and response examples."},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"001D51","highlight":"15B7FF"}},{"name":"light","logo":null,"colors":{"top-bar":"D7F2FF","right-sidebar":"001D51","highlight":"15B7FF"}}]}},"version":"8.11.6","publishDate":"2026-06-15T02:17:18.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":"Official Postman collection for the Bear Robotics Public REST API v1.3, including authentication, endpoints, request formats, and response examples."},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/30739321f59e36ae4537e39bcd5a45a05870b59a43e55d09576d08c31ccb8728","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2sBXwto8ex"}