Cove Data Protection icon

Cove Data Protection

Interact with Cove Data Protection API

Installation → Generate Token

AI-generated

Summary

Generate an agent installation token for a specified customer with configured retention policy, backup profile, encryption options, device naming, expiration settings, and device count limits.

Inputs

  • Customer Name or ID (required) — Select the customer to issue the installation token for, either from the provided list or via expression with their ID.
  • Retention Policy Name or ID (required) — Choose the retention policy to assign to devices installed with this token, selectable from the list or by specifying an ID.
  • Profile Name or ID (required) — Select the backup profile to assign to devices installed with this token, either from the list or by specifying an ID.
  • Encryption — Decide who holds the encryption key for devices - either 'Managed' (Cove generates and stores the key) or 'Self-Managed' (supplied at install and not stored).
  • Device Name — Optionally provide a name for the device created by this token; leave empty for Cove to assign one.
  • Never Expires — Set whether the installer token remains valid indefinitely.
  • Installer Expiry Date (required) — If not set to never expire, specify the exact expiry date/time for the installer token (converted internally to Unix timestamp).
  • Unlimited Devices — Specify if the installer token can be used on unlimited devices.
  • Number of Devices — If not unlimited, specify the maximum number of devices allowed to use this installer token.
  • Extra Properties — Provide additional JSON properties to customize the request body with fields not exposed via the UI.

Output shape

a single JSON object representing the installation token details returned from the API

The response includes the installation token and related metadata, reflecting all configured parameters. JSON parsing errors or invalid inputs result in a node error.

Links

Discussion