> ## Documentation index > Fetch the complete documentation index at: https://developer.rhombus.com/llms.txt > Use it to discover all available pages before exploring further. # Update camera details V2 > Update hardware details of camera. ```http POST https://api2.rhombussystems.com/api/camera/updateDetailsV2 ``` EU organizations send the same request to `https://api2.eu.rhombussystems.com`. ## Authentication and parameters - `x-auth-apikey` (header, required): Your Rhombus API key. Must be accompanied by the `x-auth-scheme` header set to `api-token` (or `partner-api-token` for partner endpoints). - `Authorization` (header): instead of an API key, an OAuth access token (`Bearer `) with the `write` scope. - `x-auth-scheme` (header, string, default: `api-token`): Authentication scheme identifier. Use `api-token` or `partner-api-token` with the `x-auth-apikey` header, `api` or `partner-api` with `x-auth-apikey` plus a client certificate, `api-oauth-token` or `partner-api-oauth-token` with `x-auth-access-token`, and `federated-token` with `x-auth-ft`. A request with `Authorization: Bearer ` and no `x-auth-scheme` is treated as OAuth, and `federated-token` may also be sent as the `x-auth-scheme` and `x-auth-ft` query parameters. One of: `api-token`, `api`, `api-oauth-token`, `federated-token`, `partner-api-token`, `partner-api`, `partner-api-oauth-token`. - `x-auth-org` (header, string): Client organization UUID (22-character RUUID), for partner credentials only. With it the call runs in that client organization with the partner support authority's role. Without it a partner credential runs as the partner organization, which outside the partner endpoints is deprecated (responses carry `Deprecation` and `Sunset: Tue, 05 Jan 2027 00:00:00 GMT`). A malformed value returns 400 `INVALID_AUTH_ORG`; a client organization the partner cannot access returns 403 `PARTNER_CLIENT_ACCESS_DENIED`. ## Request body Content type: `application/json`. Request to update camera information V2 with partial update support. - `customData` (string | null): Custom data for the camera - `customDataUpdated` (boolean | null): Whether custom data was updated - `deleted` (boolean | null): Whether the camera is deleted - `deletedUpdated` (boolean | null): Whether deleted status was updated - `description` (string | null): Description of the camera - `descriptionUpdated` (boolean | null): Whether description was updated - `directionRadians` (number | null): Direction in radians - `directionRadiansUpdated` (boolean | null): Whether direction radians was updated - `facetNameMap` (map | null): Mapping of device facets to names - `facetNameMapUpdated` (boolean | null): Whether facet name map was updated - `floorNumber` (integer | null): Floor number - `floorNumberUpdated` (boolean | null): Whether floor number was updated - `latitude` (number | null): Latitude coordinate - `latitudeUpdated` (boolean | null): Whether latitude was updated - `locationUuid` (string | null): base 64 (url-safe) uuid string - `locationUuidUpdated` (boolean | null): Whether location UUID was updated - `longitude` (number | null): Longitude coordinate - `longitudeUpdated` (boolean | null): Whether longitude was updated - `mummified` (boolean | null): Whether the camera is mummified - `mummifiedUpdated` (boolean | null): Whether mummified status was updated - `name` (string | null): Name of the camera - `nameUpdated` (boolean | null): Whether name was updated - `policyUuid` (string | null): base 64 (url-safe) uuid string - `policyUuidUpdated` (boolean | null): Whether policy UUID was updated - `subLocationsHierarchyKey` (string | null): A sequence of one or more base 64 (url-safe) uuid substrings. These substrings are separated by dots (.). - `subLocationsHierarchyKeyUpdated` (boolean | null): Whether sub-locations hierarchy key was updated - `uuid` (string | null): base 64 (url-safe) uuid string ## Response 200 OK. Content type: `application/json` - `error` (boolean | null) - `errorCode` (string | null): Stable, machine-readable code for the failure (one of the ApiErrorCode catalog) when error is true. Branch on this, not on errorMsg. - `errorMsg` (string | null) - `warningMsg` (string | null) ## Errors Also 400, 401, 403, 429, 500, 503 with the standard error body (`errorCode`, `errorMsg`): https://developer.rhombus.com/errors ## OpenAPI ````yaml openapi: 3.0.1 info: title: Rhombus API version: "1.0" servers: - description: Production Server url: https://api2.rhombussystems.com security: - ApiKeyAuth: [] paths: /api/camera/updateDetailsV2: post: description: Update hardware details of camera. operationId: updateCameraDetailsV2 parameters: - description: "Authentication scheme identifier. Use `api-token` or `partner-api-token` with the `x-auth-apikey` header, `api` or `partner-api` with `x-auth-apikey` plus a client certificate, `api-oauth-token` or `partner-api-oauth-token` with `x-auth-access-token`, and `federated-token` with `x-auth-ft`. A request with `Authorization: Bearer ` and no `x-auth-scheme` is treated as OAuth, and `federated-token` may also be sent as the `x-auth-scheme` and `x-auth-ft` query parameters." example: api-token in: header name: x-auth-scheme required: false schema: default: api-token enum: - api-token - api - api-oauth-token - federated-token - partner-api-token - partner-api - partner-api-oauth-token type: string - description: "Client organization UUID (22-character RUUID), for partner credentials only. With it the call runs in that client organization with the partner support authority's role. Without it a partner credential runs as the partner organization, which outside the partner endpoints is deprecated (responses carry `Deprecation` and `Sunset: Tue, 05 Jan 2027 00:00:00 GMT`). A malformed value returns 400 `INVALID_AUTH_ORG`; a client organization the partner cannot access returns 403 `PARTNER_CLIENT_ACCESS_DENIED`." in: header name: x-auth-org required: false schema: format: RUUID maxLength: 22 minLength: 22 type: string requestBody: content: application/json: schema: $ref: "#/components/schemas/Camera_UpdateCameraV2WSRequest" responses: "200": content: application/json: schema: $ref: "#/components/schemas/Camera_UpdateCameraV2WSResponse" description: OK "400": $ref: "#/components/responses/BadRequest" "401": $ref: "#/components/responses/Unauthorized" "403": $ref: "#/components/responses/Forbidden" "429": $ref: "#/components/responses/TooManyRequests" "500": $ref: "#/components/responses/InternalServerError" "503": $ref: "#/components/responses/ServiceUnavailable" security: - ApiKeyAuth: [] - oauth2: - write summary: Update camera details V2 tags: - Camera Webservice components: schemas: Camera_UpdateCameraV2WSRequest: description: Request to update camera information V2 with partial update support. properties: customData: description: Custom data for the camera nullable: true type: string customDataUpdated: description: Whether custom data was updated example: false nullable: true type: boolean deleted: description: Whether the camera is deleted example: false nullable: true type: boolean deletedUpdated: description: Whether deleted status was updated example: false nullable: true type: boolean description: description: Description of the camera example: Camera monitoring the front entrance nullable: true type: string descriptionUpdated: description: Whether description was updated example: false nullable: true type: boolean directionRadians: description: Direction in radians example: 1.5708 format: float nullable: true type: number directionRadiansUpdated: description: Whether direction radians was updated example: false nullable: true type: boolean facetNameMap: additionalProperties: description: Mapping of device facets to names nullable: true type: string description: Mapping of device facets to names nullable: true type: object facetNameMapUpdated: description: Whether facet name map was updated example: false nullable: true type: boolean floorNumber: description: Floor number example: 1 format: int32 nullable: true type: integer floorNumberUpdated: description: Whether floor number was updated example: false nullable: true type: boolean latitude: description: Latitude coordinate example: 37.7749 format: double nullable: true type: number latitudeUpdated: description: Whether latitude was updated example: false nullable: true type: boolean locationUuid: description: base 64 (url-safe) uuid string example: AAAAAAAAAAAAAAAAAAAAAA format: RUUID nullable: true type: string locationUuidUpdated: description: Whether location UUID was updated example: false nullable: true type: boolean longitude: description: Longitude coordinate example: -122.4194 format: double nullable: true type: number longitudeUpdated: description: Whether longitude was updated example: false nullable: true type: boolean mummified: description: Whether the camera is mummified example: false nullable: true type: boolean mummifiedUpdated: description: Whether mummified status was updated example: false nullable: true type: boolean name: description: Name of the camera example: Front Door Camera nullable: true type: string nameUpdated: description: Whether name was updated example: false nullable: true type: boolean policyUuid: description: base 64 (url-safe) uuid string example: AAAAAAAAAAAAAAAAAAAAAA format: RUUID nullable: true type: string policyUuidUpdated: description: Whether policy UUID was updated example: false nullable: true type: boolean subLocationsHierarchyKey: description: | A sequence of one or more base 64 (url-safe) uuid substrings. These substrings are separated by dots (.). example: AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA format: SubLocationsHierarchyKey nullable: true pattern: ^([A-Za-z0-9\-_]{22})([.][A-Za-z0-9\-_]{22})*$ type: string subLocationsHierarchyKeyUpdated: description: Whether sub-locations hierarchy key was updated example: false nullable: true type: boolean uuid: description: base 64 (url-safe) uuid string example: AAAAAAAAAAAAAAAAAAAAAA format: RUUID nullable: true type: string type: object Camera_UpdateCameraV2WSResponse: description: Response indicating the result of updating camera information V2. 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 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 `. 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 ````