VEverdun
integrations

Rotate Integration Credentials

put/parents/{parent_id}/integrations/{integration_id}/credentials

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/parents/{parent_id}/integrations/{integration_id}/credentials
  • Auth
    HTTP bearer

Path parameters

parent_idstring required
integration_idstring required

Request body

api_keystring password required

Replacement provider API key. WRITE-ONLY, and validated against the provider before the stored secret is overwritten — a rejected key leaves the existing credentials untouched.

org_idstring nullable

Replacement organization id. Omit to keep the stored one (the same omitted-means-unchanged contract as the NVR edit password), so rotating a key alone cannot silently drop the org id.

usernamestring nullable

AvertX only: a replacement sign-in email. Omit to keep the stored one (omitted-means-unchanged, like org_id). Ignored by Verkada and Turing.

Example request

{
  "api_key": "<API_KEY>",
  "org_id": "ceb8ff18-0000-0000-0000-000000000000",
  "username": "support@verdun.ai"
}

Response

Successful Response

idstring uuid required

The integration record ID.

parent_idstring uuid required

The client this connection belongs to. The credential is client-level; WHICH SITES it serves is site_ids.

provider'verkada' | 'turing' | 'avertx' required
labelstring required

Operator-facing name for this connection.

external_org_idstring nullable

Provider organization id (non-secret), for display.

command_short_namestring nullable

The vendor console's organization short name (the subdomain in https://<short-name>.command.verkada.com/...). Owner-entered, never fetched from the provider, and used only to build an operator's deep link. A Verkada concept: providers whose console has no such deep link leave it null.

status'active' | 'error' required
last_verified_atstring date-time nullable

When the connection last tested successfully.

last_errorstring nullable

Most recent connection-test failure, sanitized and truncated. Never contains a credential.

site_idsstring[]

The live sites this connection is assigned to, ordered by id. Empty means UNASSIGNED: the connection is listed and manageable but no site uses it yet. Absent from payloads of older servers (read as empty).

created_atstring date-time required

When the connection was created.

updated_atstring date-time nullable

When the connection was last modified.

Example response

{
  "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.