{"url":"/api-reference/robot-webservice/update-robot-details","method":"POST","path":"/api/robot/updateDetails","tag":"Robot Webservice","title":"Update robot details","operation":{"description":"Update hardware details of robot.","operationId":"updateRobotDetails","parameters":[{"description":"Authentication scheme identifier. Use `api-token` for standard API key authentication, `partner-api-token` for partner API key authentication. Must be paired with the `x-auth-apikey` header containing your API key.","example":"api-token","in":"header","name":"x-auth-scheme","required":true,"schema":{"default":"api-token","enum":["api-token","api","partner-api-token","partner-api"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Robot_UpdateRobotDetailsWSRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Common_devices_UpdateDeviceDetailsWSResponse"}}},"description":"OK"}},"summary":"Update robot details","tags":["Robot Webservice"]},"auth":{"headers":[{"description":"Your Rhombus API key. Must be accompanied by the `x-auth-scheme` header set to `api-token` (or `partner-api-token` for partner endpoints).","in":"header","name":"x-auth-apikey","type":"apiKey"}]},"components":{"schemas":{"Common_devices_UpdateDeviceDetailsWSResponse":{"properties":{"error":{"nullable":true,"type":"boolean"},"errorCode":{"description":"Stable, machine-readable code for the failure (one of the ApiErrorCode catalog) when error is true. Branch on this, not on errorMsg.","nullable":true,"type":"string"},"errorMsg":{"nullable":true,"type":"string"},"warningMsg":{"nullable":true,"type":"string"}},"type":"object"},"Robot_UpdateRobotDetailsWSRequest":{"description":"Request to update robot details.","properties":{"description":{"description":"Optional description for the robot","example":"Patrols the lobby.","nullable":true,"type":"string"},"deviceUuid":{"description":"base 64 (url-safe) uuid string","example":"AAAAAAAAAAAAAAAAAAAAAA","format":"RUUID","nullable":true,"type":"string"},"latitude":{"description":"Optional latitude coordinate","example":37.7749,"format":"double","nullable":true,"type":"number"},"locationUuid":{"description":"base 64 (url-safe) uuid string","example":"AAAAAAAAAAAAAAAAAAAAAA","format":"RUUID","nullable":true,"type":"string"},"longitude":{"description":"Optional longitude coordinate","example":-122.4194,"format":"double","nullable":true,"type":"number"},"name":{"description":"Optional name for the robot","example":"Robocop","nullable":true,"type":"string"},"subLocationsHierarchyKey":{"description":"A sequence of one or more base 64 (url-safe) uuid substrings.\nThese substrings are separated by dots (.).\n","example":"AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA","format":"SubLocationsHierarchyKey","nullable":true,"pattern":"^([A-Za-z0-9\\-_]{22})([.][A-Za-z0-9\\-_]{22})*$","type":"string"},"subLocationsHierarchyKeyUpdated":{"description":"Whether the sub-locations hierarchy key has been updated","example":false,"nullable":true,"type":"boolean"}},"type":"object"}},"securitySchemes":{"ApiKeyAuth":{"description":"Your Rhombus API key. Must be accompanied by the `x-auth-scheme` header set to `api-token` (or `partner-api-token` for partner endpoints).","in":"header","name":"x-auth-apikey","type":"apiKey"},"oauth2":{"description":"OAuth 2.0 authorization code flow with PKCE (`S256`). Send the access token as `Authorization: Bearer <token>`. Each operation lists the scopes it requires; a token without them is refused 403 with `WWW-Authenticate: Bearer error=\"insufficient_scope\"`.","flows":{"authorizationCode":{"authorizationUrl":"https://console.rhombus.com/oauth/authorize","refreshUrl":"https://auth-web.rhombussystems.com/oauth/token","scopes":{"physical":"Unlock doors and elevators, lockdown, alarms, speakers and robots","read":"View cameras, footage and settings","write":"Change settings and data"},"tokenUrl":"https://auth-web.rhombussystems.com/oauth/token"}},"type":"oauth2"}}},"highlight":{"samples":{"cURL":[["text-code-function","curl"],[""," "],["text-code-string","--request"],[""," "],["text-code-string","POST"],[""," \\\n  "],["text-code-string","--url"],[""," "],["text-code-punctuation","'"],["text-code-string","https://api2.rhombussystems.com/api/robot/updateDetails"],["text-code-punctuation","'"],[""," \\\n  "],["text-code-string","--header"],[""," "],["text-code-punctuation","'"],["text-code-string","x-auth-scheme: api-token"],["text-code-punctuation","'"],[""," \\\n  "],["text-code-string","--header"],[""," "],["text-code-punctuation","'"],["text-code-string","x-auth-apikey: YOUR_API_KEY"],["text-code-punctuation","'"],[""," \\\n  "],["text-code-string","--header"],[""," "],["text-code-punctuation","'"],["text-code-string","Content-Type: application/json"],["text-code-punctuation","'"],[""," \\\n  "],["text-code-string","--data"],[""," "],["text-code-punctuation","'"],["text-code-string","{"],["","\n"],["text-code-string","    \"description\": \"Patrols the lobby.\","],["","\n"],["text-code-string","    \"deviceUuid\": \"AAAAAAAAAAAAAAAAAAAAAA\","],["","\n"],["text-code-string","    \"latitude\": 37.7749,"],["","\n"],["text-code-string","    \"locationUuid\": \"AAAAAAAAAAAAAAAAAAAAAA\","],["","\n"],["text-code-string","    \"longitude\": -122.4194,"],["","\n"],["text-code-string","    \"name\": \"Robocop\","],["","\n"],["text-code-string","    \"subLocationsHierarchyKey\": \"AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA\","],["","\n"],["text-code-string","    \"subLocationsHierarchyKeyUpdated\": false"],["","\n"],["text-code-string","  }"],["text-code-punctuation","'"]],"Python":[["text-code-keyword","import"],[""," requests\n\nurl "],["text-code-punctuation","="],[""," "],["text-code-punctuation","\""],["text-code-string","https://api2.rhombussystems.com/api/robot/updateDetails"],["text-code-punctuation","\""],["","\nheaders "],["text-code-punctuation","="],[""," "],["text-code-punctuation","{"],["","\n    "],["text-code-punctuation","\""],["text-code-string","x-auth-scheme"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","api-token"],["text-code-punctuation","\","],["","\n    "],["text-code-punctuation","\""],["text-code-string","x-auth-apikey"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","YOUR_API_KEY"],["text-code-punctuation","\","],["","\n    "],["text-code-punctuation","\""],["text-code-string","Content-Type"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","application/json"],["text-code-punctuation","\","],["","\n"],["text-code-punctuation","}"],["","\npayload "],["text-code-punctuation","="],[""," "],["text-code-punctuation","{"],["","\n    "],["text-code-punctuation","\""],["text-code-string","description"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","Patrols the lobby."],["text-code-punctuation","\","],["","\n    "],["text-code-punctuation","\""],["text-code-string","deviceUuid"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","AAAAAAAAAAAAAAAAAAAAAA"],["text-code-punctuation","\","],["","\n    "],["text-code-punctuation","\""],["text-code-string","latitude"],["text-code-punctuation","\":"],[""," "],["text-code-number","37.7749"],["text-code-punctuation",","],["","\n    "],["text-code-punctuation","\""],["text-code-string","locationUuid"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","AAAAAAAAAAAAAAAAAAAAAA"],["text-code-punctuation","\","],["","\n    "],["text-code-punctuation","\""],["text-code-string","longitude"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","-"],["text-code-number","122.4194"],["text-code-punctuation",","],["","\n    "],["text-code-punctuation","\""],["text-code-string","name"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","Robocop"],["text-code-punctuation","\","],["","\n    "],["text-code-punctuation","\""],["text-code-string","subLocationsHierarchyKey"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA"],["text-code-punctuation","\","],["","\n    "],["text-code-punctuation","\""],["text-code-string","subLocationsHierarchyKeyUpdated"],["text-code-punctuation","\":"],[""," "],["text-code-number","False"],["","\n"],["text-code-punctuation","}"],["","\n\nresponse "],["text-code-punctuation","="],[""," requests"],["text-code-punctuation","."],["text-code-function","post"],["text-code-punctuation","("],["text-code-function","url"],["text-code-punctuation",","],["text-code-function"," "],["","headers"],["text-code-punctuation","="],["text-code-function","headers"],["text-code-punctuation",","],["text-code-function"," "],["","json"],["text-code-punctuation","="],["text-code-function","payload"],["text-code-punctuation",")"],["","\nresponse"],["text-code-punctuation","."],["text-code-function","raise_for_status"],["text-code-punctuation","()"],["","\n"],["text-code-function","print"],["text-code-punctuation","("],["text-code-function","response"],["text-code-punctuation","."],["text-code-function","json"],["text-code-punctuation","())"]],"JavaScript":[["text-code-keyword","const"],[""," response "],["text-code-punctuation","="],[""," "],["text-code-keyword","await"],[""," "],["text-code-function","fetch"],["text-code-punctuation","('"],["text-code-string","https://api2.rhombussystems.com/api/robot/updateDetails"],["text-code-punctuation","',"],[""," "],["text-code-punctuation","{"],["","\n  "],["text-code-property","method"],["text-code-punctuation",":"],[""," "],["text-code-punctuation","'"],["text-code-string","POST"],["text-code-punctuation","',"],["","\n  "],["text-code-property","headers"],["text-code-punctuation",":"],[""," "],["text-code-punctuation","{"],["","\n    "],["text-code-punctuation","'"],["text-code-string","x-auth-scheme"],["text-code-punctuation","':"],[""," "],["text-code-punctuation","'"],["text-code-string","api-token"],["text-code-punctuation","',"],["","\n    "],["text-code-punctuation","'"],["text-code-string","x-auth-apikey"],["text-code-punctuation","':"],[""," "],["text-code-punctuation","'"],["text-code-string","YOUR_API_KEY"],["text-code-punctuation","',"],["","\n    "],["text-code-punctuation","'"],["text-code-string","Content-Type"],["text-code-punctuation","':"],[""," "],["text-code-punctuation","'"],["text-code-string","application/json"],["text-code-punctuation","',"],["","\n  "],["text-code-punctuation","},"],["","\n  "],["text-code-property","body"],["text-code-punctuation",":"],[""," JSON"],["text-code-punctuation","."],["text-code-function","stringify"],["text-code-punctuation","({"],["","\n    "],["text-code-punctuation","\""],["text-code-string","description"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","Patrols the lobby."],["text-code-punctuation","\","],["","\n    "],["text-code-punctuation","\""],["text-code-string","deviceUuid"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","AAAAAAAAAAAAAAAAAAAAAA"],["text-code-punctuation","\","],["","\n    "],["text-code-punctuation","\""],["text-code-string","latitude"],["text-code-punctuation","\":"],[""," "],["text-code-number","37.7749"],["text-code-punctuation",","],["","\n    "],["text-code-punctuation","\""],["text-code-string","locationUuid"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","AAAAAAAAAAAAAAAAAAAAAA"],["text-code-punctuation","\","],["","\n    "],["text-code-punctuation","\""],["text-code-string","longitude"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","-"],["text-code-number","122.4194"],["text-code-punctuation",","],["","\n    "],["text-code-punctuation","\""],["text-code-string","name"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","Robocop"],["text-code-punctuation","\","],["","\n    "],["text-code-punctuation","\""],["text-code-string","subLocationsHierarchyKey"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA"],["text-code-punctuation","\","],["","\n    "],["text-code-punctuation","\""],["text-code-string","subLocationsHierarchyKeyUpdated"],["text-code-punctuation","\":"],[""," "],["text-code-number","false"],["","\n  "],["text-code-punctuation","}),"],["","\n"],["text-code-punctuation","});"],["","\n"],["text-code-keyword","if"],[""," "],["text-code-punctuation","(!"],["","response"],["text-code-punctuation","."],["text-code-property","ok"],["text-code-punctuation",")"],[""," "],["text-code-keyword","throw"],[""," "],["text-code-keyword","new"],[""," "],["text-code-function","Error"],["text-code-punctuation","(`${"],["","response"],["text-code-punctuation","."],["text-code-property","status"],["text-code-punctuation","}"],["text-code-string",": "],["text-code-punctuation","${"],["text-code-keyword","await"],["text-code-string"," "],["","response"],["text-code-punctuation","."],["text-code-function","text"],["text-code-punctuation","()}`);"],["","\n\nconsole"],["text-code-punctuation","."],["text-code-function","log"],["text-code-punctuation","("],["text-code-keyword","await"],[""," response"],["text-code-punctuation","."],["text-code-function","json"],["text-code-punctuation","());"]],"Java":[["text-code-keyword","import"],[""," "],["text-code-keyword","java"],["text-code-punctuation","."],["text-code-keyword","net"],["text-code-punctuation","."],["text-code-keyword","URI"],["text-code-punctuation",";"],["","\n"],["text-code-keyword","import"],[""," "],["text-code-keyword","java"],["text-code-punctuation","."],["text-code-keyword","net"],["text-code-punctuation","."],["text-code-keyword","http"],["text-code-punctuation","."],["text-code-keyword","HttpClient"],["text-code-punctuation",";"],["","\n"],["text-code-keyword","import"],[""," "],["text-code-keyword","java"],["text-code-punctuation","."],["text-code-keyword","net"],["text-code-punctuation","."],["text-code-keyword","http"],["text-code-punctuation","."],["text-code-keyword","HttpRequest"],["text-code-punctuation",";"],["","\n"],["text-code-keyword","import"],[""," "],["text-code-keyword","java"],["text-code-punctuation","."],["text-code-keyword","net"],["text-code-punctuation","."],["text-code-keyword","http"],["text-code-punctuation","."],["text-code-keyword","HttpResponse"],["text-code-punctuation",";"],["","\n\n"],["text-code-keyword","public"],[""," "],["text-code-keyword","class"],[""," Example "],["text-code-punctuation","{"],["","\n    "],["text-code-keyword","public"],[""," "],["text-code-keyword","static"],[""," "],["text-code-keyword","void"],[""," "],["text-code-function","main"],["text-code-punctuation","("],["text-code-keyword","String"],["text-code-punctuation","[]"],[""," args"],["text-code-punctuation",")"],[""," "],["text-code-keyword","throws"],[""," "],["text-code-keyword","Exception"],[""," "],["text-code-punctuation","{"],["","\n        "],["text-code-keyword","String"],[""," body "],["text-code-punctuation","="],[""," "],["text-code-punctuation","\"\"\""],["","\n"],["text-code-string","            {"],["","\n"],["text-code-string","              \"description\": \"Patrols the lobby.\","],["","\n"],["text-code-string","              \"deviceUuid\": \"AAAAAAAAAAAAAAAAAAAAAA\","],["","\n"],["text-code-string","              \"latitude\": 37.7749,"],["","\n"],["text-code-string","              \"locationUuid\": \"AAAAAAAAAAAAAAAAAAAAAA\","],["","\n"],["text-code-string","              \"longitude\": -122.4194,"],["","\n"],["text-code-string","              \"name\": \"Robocop\","],["","\n"],["text-code-string","              \"subLocationsHierarchyKey\": \"AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA\","],["","\n"],["text-code-string","              \"subLocationsHierarchyKeyUpdated\": false"],["","\n"],["text-code-string","            }"],["","\n"],["text-code-string","            "],["text-code-punctuation","\"\"\";"],["","\n        "],["text-code-keyword","HttpRequest"],[""," request "],["text-code-punctuation","="],[""," HttpRequest"],["text-code-punctuation","."],["text-code-function","newBuilder"],["text-code-punctuation","()"],["","\n            "],["text-code-punctuation","."],["text-code-function","uri"],["text-code-punctuation","("],["","URI"],["text-code-punctuation","."],["text-code-function","create"],["text-code-punctuation","(\""],["text-code-string","https://api2.rhombussystems.com/api/robot/updateDetails"],["text-code-punctuation","\"))"],["","\n            "],["text-code-punctuation","."],["text-code-function","header"],["text-code-punctuation","(\""],["text-code-string","x-auth-scheme"],["text-code-punctuation","\","],[""," "],["text-code-punctuation","\""],["text-code-string","api-token"],["text-code-punctuation","\")"],["","\n            "],["text-code-punctuation","."],["text-code-function","header"],["text-code-punctuation","(\""],["text-code-string","x-auth-apikey"],["text-code-punctuation","\","],[""," "],["text-code-punctuation","\""],["text-code-string","YOUR_API_KEY"],["text-code-punctuation","\")"],["","\n            "],["text-code-punctuation","."],["text-code-function","header"],["text-code-punctuation","(\""],["text-code-string","Content-Type"],["text-code-punctuation","\","],[""," "],["text-code-punctuation","\""],["text-code-string","application/json"],["text-code-punctuation","\")"],["","\n            "],["text-code-punctuation","."],["text-code-function","method"],["text-code-punctuation","(\""],["text-code-string","POST"],["text-code-punctuation","\","],[""," HttpRequest"],["text-code-punctuation","."],["","BodyPublishers"],["text-code-punctuation","."],["text-code-function","ofString"],["text-code-punctuation","("],["","body"],["text-code-punctuation","))"],["","\n            "],["text-code-punctuation","."],["text-code-function","build"],["text-code-punctuation","();"],["","\n        "],["text-code-keyword","HttpResponse"],["text-code-punctuation","<"],["text-code-keyword","String"],["text-code-punctuation",">"],[""," response "],["text-code-punctuation","="],[""," HttpClient"],["text-code-punctuation","."],["text-code-function","newHttpClient"],["text-code-punctuation","()"],["","\n            "],["text-code-punctuation","."],["text-code-function","send"],["text-code-punctuation","("],["","request"],["text-code-punctuation",","],[""," HttpResponse"],["text-code-punctuation","."],["","BodyHandlers"],["text-code-punctuation","."],["text-code-function","ofString"],["text-code-punctuation","());"],["","\n        System"],["text-code-punctuation","."],["","out"],["text-code-punctuation","."],["text-code-function","println"],["text-code-punctuation","("],["","response"],["text-code-punctuation","."],["text-code-function","statusCode"],["text-code-punctuation","()"],[""," "],["text-code-punctuation","+"],[""," "],["text-code-punctuation","\""],["text-code-string"," "],["text-code-punctuation","\""],[""," "],["text-code-punctuation","+"],[""," response"],["text-code-punctuation","."],["text-code-function","body"],["text-code-punctuation","());"],["","\n    "],["text-code-punctuation","}"],["","\n"],["text-code-punctuation","}"]]},"responses":{"200":[["text-code-punctuation","{"],["","\n  "],["text-code-punctuation","\""],["text-code-property","error"],["text-code-punctuation","\":"],[""," "],["text-code-number","false"],["text-code-punctuation",","],["","\n  "],["text-code-punctuation","\""],["text-code-property","errorCode"],["text-code-punctuation","\":"],[""," "],["text-code-punctuation","\""],["text-code-string","<string>"],["text-code-punctuation","\""],["","\n"],["text-code-punctuation","}"]]}}}