Update organization

Update an organization and its properties.

The default general purge time is 31 days. To increase purge times above this amount, speak to your partner success manager (PSM).

Note: PATCH calls update data partially. Any data not mentioned in the call, will be kept as is.

Request
Security:
path Parameters
orgId
required
string

The ID of the organization. Obtain this from GET /organizations.

Example: 62
Request Body schema: application/json
name
string (Organization name)

The name assigned to the organization in POST /organizations.

exclusivePartnerOnly
boolean (Organization can contain devices of one partner or multiple partners)

When enabled, the organization can only contain devices from the partner that originally created the organization. When disabled, the organization can contain devices from multiple partners.

purgeDays
number (Purge time) [ 1 .. 366 ]

The amount of time that an organization’s data is retained in the cloud before being purged, in days. The default general purge time is 31 days. To increase the purge time above this amount, speak to your partner success manager (PSM).

Purge times can be set separately for each camera type (1 - road-facing lens, 2 - in-cab lens, 50+ - auxiliary cameras.)

purgeDaysFrontCamera
number (Purge time) [ 1 .. 366 ]

The amount of time that an organization’s data is retained in the cloud before being purged, in days. The default general purge time is 31 days. To increase the purge time above this amount, speak to your partner success manager (PSM).

Purge times can be set separately for each camera type (1 - road-facing lens, 2 - in-cab lens, 50+ - auxiliary cameras.)

purgeDaysRearCamera
number (Purge time) [ 1 .. 366 ]

The amount of time that an organization’s data is retained in the cloud before being purged, in days. The default general purge time is 31 days. To increase the purge time above this amount, speak to your partner success manager (PSM).

Purge times can be set separately for each camera type (1 - road-facing lens, 2 - in-cab lens, 50+ - auxiliary cameras.)

purgeDaysAuxiliaryCameras
number (Purge time) [ 1 .. 366 ]

The amount of time that an organization’s data is retained in the cloud before being purged, in days. The default general purge time is 31 days. To increase the purge time above this amount, speak to your partner success manager (PSM).

Purge times can be set separately for each camera type (1 - road-facing lens, 2 - in-cab lens, 50+ - auxiliary cameras.)

deviceRetentionMinutes
number (Recording retention configuration for all devices in an organization) >= 4

The configuration of the recording retention for all devices in the specified organization. The recording retention is how long recordings are stored on the SD card until they get overwritten with new recordings. This field sets the value for all of the devices in the specified organization.

isOrganizationProfileEnabled
boolean (isOrganizationProfileEnabled)
Default: true

Enable the organization profile for all devices. If disabled, the organization profile doesnt apply, and each device is managed separately.

This profile enables you to configure all devices in the organization with the same configuration. When turned on, all new devices are automatically configured with this profile when added; when turned off, devices that are newly added to the organization do not get the configuration from this profile.

Note: when enabled and users configure settings using a combination of single, bulk and this profile, each device is configured based on its most recent updates, regardless of method.

deIdEnabled
boolean (Organizations can have the Blurring service enabled/disabled)
Default: false

When enabled, the organization can have the Blurring service turned on for the devices. If disabled, the Blurring service cannot be turned on for the devices.

Note: These settings for exisitng organizations are automatically inherited from the partner configuration. The Blurring service will only work for the organization if it was also turned on at a partner level.

deIdBacklogEnabled
boolean (Media blurring service in backlog enabled/disabled)
Default: false

When enabled, blurring service will be enabled for all the media files in the backlog. If disabled, the blurring service will be available only for real-time requests.

deIdEnableStrictBlurring
boolean (Adds more blurred area and blurring intensity)
Default: false

Strict blurring prioritizes privacy over False positives. It adds a larger blurred area and blurring intensity. When enabled, the organization can have strict blurring turned on for all devices. Strict blurring provides an improvement in blurring accuracy and is enabled by default for organizations who want higher privacy at the cost of a minor increase in false positives.

Note: These settings for exisitng organizations are automatically inherited from the partner configuration. Strict Blurring service will only work for the organization if it is also turned on at a partner level.

liveVideoTimeoutSeconds
number >= 30

The duration, in seconds, that live video plays before ending automatically.

Responses
200

Successful operation

400

Bad request error

401

Unauthorized error

403

Forbidden error

500

Internal server error

patch/organizations/{orgId}
Request samples
application/json
{
  • "name": "Company Name",
  • "exclusivePartnerOnly": true,
  • "purgeDays": 90,
  • "purgeDaysFrontCamera": 90,
  • "purgeDaysRearCamera": 90,
  • "purgeDaysAuxiliaryCameras": 90,
  • "deviceRetentionMinutes": 4,
  • "isOrganizationProfileEnabled": true,
  • "deIdEnabled": false,
  • "deIdBacklogEnabled": false,
  • "deIdEnableStrictBlurring": false,
  • "liveVideoTimeoutSeconds": 30
}
Response samples
application/json
{
  • "requestId": "df5fg-45fgfdsg-45fg-45454"
}