integrations

Assign Site Integration

Assign an existing connection of the site's client to the site.

Idempotent (200, already_assigned: true) for the same pair. 404 for a connection of another client (out-of-tenant is not found). 409 when the site already uses a DIFFERENT connection of that provider, or has live cameras still streaming through one.

put/sites/{site_id}/integrations/{integration_id}

Request

  • Base URL
    https://api.verdun.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.verdun.ai/sites/{site_id}/integrations/{integration_id}
  • Auth
    HTTP bearer

Path parameters

site_idstring required
integration_idstring required

Response

Successful Response

site_idstring uuid required

The site the connection is now assigned to.

already_assignedboolean required

True when the connection was already assigned to this site and nothing was written (the call is idempotent).

Example response

{
  "integration": {
    "label": "Northgate Command",
    "external_org_id": "ceb8ff18-0000-0000-0000-000000000000",
    "command_short_name": "northgate-security",
    "last_error": "The provider rejected the supplied API key."
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.