Add/Update Site Enterprise

If a business is a large enterprise that requires many site groups, you can create a Site Enterprise which can contain many Site Groups.

Endpoint

The following endpoint can be used to add or update site enterprises. You must replace the {base_url} variable.

POST

{base_url}/api/v4/siteEnterprise/addUpdate

The same endpoint is used to add or update a site enterprise. If the {_id} is provided, the site enterprise will be updated otherwise it will be inserted.

Request

Field

Type

Description

externalId

String

The unique site enterprise id from the source system/database. If we detect a record with the same `external_id`, it will be updated, otherwise it will be added.

name

String

The name of the site enterprise.

agency

Agency

A reference to the agency record.

deleted

Boolean

This flag represents whether the record is deleted and no longer available to be used.

Response

Field

Type

Description

success

Boolean

Whether the record was added or updated successfully.

action

String

Informs whether the record was added or updated. Will only be returned if `success` is `true`.
One of `added`, `updated`

_id

String

The auto generated id assigned to the record.

errors

String [ ]

A list of errors. Will only be returned if `success` is `false`.

Sample Response (Successful)

			
{
  "success": true,
  "action": "added",
  "_id": "60f720d248f143332af022e0"
}

Sample Response (Failed)

			
{
  "success": false,
  "errors": [
    "invalid field2",
    "missing field_name"
  ]
}