Skip to main content
Connector guides

Connect N-able Cove Data Protection

N-able Cove Data Protection (Cove) is N-able's cloud backup service. A partner manages its customers, their devices, the storage behind them and the billing for them in the Cove Management Console,…

Written By Christopher Scaminaci

Last updated 13 days ago

N-able Cove Data Protection (Cove) is N-able's cloud backup service. A partner manages its customers, their devices, the storage behind them and the billing for them in the Cove Management Console, and the Management Service API exposes the same functions. StackJack connects an AI assistant to that API.

Connecting Cove to StackJack gives your AI assistant a family of cove_ MCP tools. MCP (Model Context Protocol) tools are the standardized commands an AI assistant can call through StackJack. With them, your AI can:

  • See your customers and their devices - the customer tree under your partner, each customer's record and lifecycle state, and every device (Cove calls a device an account) with its product, type and storage
  • Read backup health - the statistics grid, with the columns you ask for, for every device under a customer, ordered, filtered and paged
  • Check the setup around them - users and roles, contacts and notes, labels and custom columns, backup profiles, notification rules, templates and report deliveries, storage and storage nodes, locations, products, features and pricing
  • Follow what happened - jobs, the audit trail of console and API actions, and a customer's lifecycle history
  • Change things (on Pro plans) - add and change customers, devices, users, storage, notification rules, products and pricing, and remove them

How StackJack authenticates to Cove

Cove has one API endpoint for every customer, so there is no address to enter. You give StackJack three things: the name of your partner, the email of an API user and that user's password. StackJack signs in on its own, keeps the short-lived session Cove returns and renews it as long as it is in use, and never shows it to the AI.

Creating the API user

  1. Sign in to the Cove Management Console as an administrator and open Settings, then Users.
  2. Add a dedicated user for StackJack, or edit an existing one. We recommend a dedicated user that does not sign in with two-factor authentication.
  3. In the user's settings, switch on API Authentication. Cove refuses the API sign-in for a user without it. Give the user a role that allows what you want the AI to do.
  4. Note the partner name you sign in under, spelled exactly as the console shows it, including capitals and spacing.

Connect it in StackJack

  1. Open Connectors, then N-able Cove Data Protection.
  2. Enter the partner name in Partner name, the user's email in API user email and its password in Password.
  3. Click Test connection. StackJack signs in and reads your partner's own record. Both steps change nothing.

Enter all three values again whenever you save the connection, including when you only rename it.

What is worth knowing before you start

The user's role decides what Cove allows

Every call acts as the API user, so the AI sees and changes only what that user's role allows, for your partner and the customers beneath it. When Cove refuses a call for that reason, the tool says so and the refusal does not count against the connection. Create the user with the access the AI needs and no more.

The tools follow Cove's own methods

Each tool is one Cove method from the published API schema, so a reader of the Cove guide can find it by name. Cove's Enumerate methods are the list_ tools. Times are Unix seconds and sizes are bytes, exactly as Cove returns them. A structured argument, such as a customer, a device, a user or a notification rule, is a JSON object; the argument's description lists its fields and the values each field takes.

Start with cove_list_partners to find the customer ids that most other tools need, and cove_list_accounts to find devices.

The statistics grid

cove_list_account_statistics returns one row per device with the columns you ask for. Cove names the columns with short codes, and lists them on its Management Console column codes page. Page through the rows with startRecordNumber and recordsCount; StackJack returns at most 1000 rows in one call.

Changing things

The tools that add, change or remove customers, devices, users, storage, jobs, notification rules, products, pricing or branding are on the Pro tier, are marked destructive and ask for approval before they run. A few harmless view and label settings are not marked destructive. Removing a customer or a device affects its backup data under Cove's retention rules, so check what a call will do before you approve it.

Three read tools are different because they create access: a sign-in link for a customer's console, a session passport for a user, and an install command line that carries an auto-deploy token. They are Pro and destructive.

Passwords, tokens and keys

A device record carries the device's own password and token, a storage node record carries a password, and some tools take a password, an encryption key or a passphrase. StackJack never records those arguments or answers, and never turns them into download links.

What is not offered

Cove's reporting service runs on each storage node at its own address and is not part of this connector. The calls that only a Cove storage node makes about its own jobs, and the sign-in methods themselves, are not offered as tools.

When Cove refuses a call

  • The sign-in is refused: the partner name, the user's email or the password is wrong, the password has expired, or the user does not have API Authentication switched on. Check them in the console and paste all three values again.
  • The user may not do that: the role does not allow the action, or the customer is outside the user's reach.
  • Not found: check the ids with cove_list_partners, cove_list_accounts, cove_list_users, cove_list_storages and cove_list_jobs.
  • A value is rejected: the answer names it. Method and argument names are case sensitive.
  • Rate limited: Cove does not publish a limit. StackJack paces its calls and backs off when Cove asks it to slow down.

Plans and limits

Reads are available on the Free tier. The tools that change things are Pro. Business reaches the same tools as Pro and differs by monthly call quota.

See the generated N-able Cove Data Protection tool reference for the current inventory, plan assignment, input schemas and destructive-action labels.

N-able Cove Data Protection tools

cove_ · 241 tools · Free 147 · Pro 94

Customers (partners)

ToolWhat it does
cove_add_partner
Pro · Destructive
DESTRUCTIVE.
cove_add_partner_ex
Pro · Destructive
DESTRUCTIVE.
cove_change_partner_state
Pro · Destructive
DESTRUCTIVE.
cove_get_partner_info
Free · Read-only
Returns one customer (partner) looked up by its exact name.
cove_get_partner_info_at_time
Free · Read-only
Returns partner info at time.
cove_get_partner_info_by_id
Free · Read-only
Returns one customer (partner) looked up by its partner id.
cove_get_partner_info_by_uid
Free · Read-only
Returns one customer (partner) looked up by its partner uid (the unique id the customer's installers carry).
cove_get_partner_info_history
Free · Read-only
Returns partner info history.
cove_get_partner_state
Free · Read-only
Returns a customer's lifecycle state (Registered, InTrial, InProduction, ...).
cove_get_partner_tree
Free · Read-only
Returns the customer tree from a partner downward, filtered by name, state and level, with a limit on children per node.
cove_get_partners_rule_applied_to
Free · Read-only
Returns partners rule applied to.
cove_get_partners_rule_inactive_for
Free · Read-only
Returns partners rule inactive for.
cove_get_root_partner_name
Free · Read-only
Returns the name of the root partner of this Cove installation.
cove_list_account_partner_id_tree
Free · Read-only
Lists account partner id tree.
cove_list_ancestor_partners
Free · Read-only
Lists ancestor partners.
cove_list_child_partners
Free · Read-only
Returns the direct children of a partner as a tree node, optionally narrowed by field list, record range and a tree filter.
cove_list_partners
Free · Read-only
Lists the customers (Cove calls them partners) under a parent partner, one level or recursively.
cove_list_partners_at_time
Free · Read-only
Lists partners at time.
cove_list_permitted_partners
Free · Read-only
Lists permitted partners.
cove_list_removed_partners
Free · Read-only
Lists removed partners.
cove_list_respect_removed_ancestor_partners_at_time
Free · Read-only
Lists respect removed ancestor partners at time.
cove_modify_partner
Pro · Destructive
DESTRUCTIVE.
cove_remove_partner
Pro · Destructive
DESTRUCTIVE.

Customer settings

ToolWhat it does
cove_get_advanced_partner_properties
Free · Read-only
Returns advanced partner properties.
cove_get_auto_deploy_command_line
Pro · Destructive
DESTRUCTIVE.
cove_get_auto_deployment_partner_state
Free · Read-only
Returns auto deployment partner state.
cove_get_auto_login_url
Pro · Destructive
DESTRUCTIVE.
cove_get_partner_url
Free · Read-only
Returns partner url.
cove_is_auto_deployment_allowed_for_partner
Free · Read-only
Returns whether auto deployment allowed for partner.
cove_is_direct_debtor_partner
Free · Read-only
Returns whether direct debtor partner.
cove_is_sims_plugin_enabled
Free · Read-only
Returns whether sims plugin enabled.
cove_is_sims_plugin_enabled_for_any_child
Free · Read-only
Returns whether sims plugin enabled for any child.
cove_list_advanced_partner_properties_infos
Free · Read-only
Lists advanced partner properties infos.
cove_list_advanced_partner_properties_infos_by_partner_ids
Free · Read-only
Lists advanced partner properties infos by partner ids.
cove_list_external_partner_properties
Free · Read-only
Lists external partner properties.
cove_list_partner_properties
Free · Read-only
Lists partner properties.
cove_list_partner_state_transitions
Free · Read-only
Lists partner state transitions.
cove_list_partner_states_by_period
Free · Read-only
Lists partner states by period.
cove_list_partner_urls
Free · Read-only
Lists partner urls.
cove_list_unique_partner_states_by_period
Free · Read-only
Lists unique partner states by period.
cove_modify_auto_deployment_partner_state
Pro · Destructive
DESTRUCTIVE.
cove_regenerate_partner_uid
Pro · Destructive
DESTRUCTIVE.
cove_register_external_partner_property
Pro · Destructive
DESTRUCTIVE.
cove_set_advanced_partner_properties
Pro · Destructive
DESTRUCTIVE.
cove_set_partner_url
Pro · Destructive
DESTRUCTIVE.

Devices (accounts)

ToolWhat it does
cove_add_account
Pro · Destructive
DESTRUCTIVE.
cove_generate_reinstallation_passphrase
Pro · Destructive
DESTRUCTIVE.
cove_get_account_id
Free · Read-only
Returns account id.
cove_get_account_info
Free · Read-only
Returns one device (account) by its name and password.
cove_get_account_info_by_id
Free · Read-only
Returns one device (account) by its id, with its home storage node.
cove_get_account_info_by_id_with_removed
Free · Read-only
Returns account info by id with removed.
cove_get_account_info_by_token
Free · Read-only
Returns account info by token.
cove_get_encryption_key_by_passphrase
Free · Read-only
Returns encryption key by passphrase.
cove_get_remote_client_connection_locator
Free · Read-only
Returns remote client connection locator.
cove_list_account_remote_access_endpoints
Free · Read-only
Lists account remote access endpoints.
cove_list_accounts
Free · Read-only
Lists the devices (Cove calls a device an account) of one customer.
cove_list_removed_accounts_by_ids
Free · Read-only
Lists removed accounts by ids.
cove_modify_account
Pro · Destructive
DESTRUCTIVE.
cove_modify_accounts_batch
Pro · Destructive
DESTRUCTIVE.
cove_remove_account
Pro · Destructive
DESTRUCTIVE.
cove_remove_account_data
Pro · Destructive
DESTRUCTIVE.
cove_verify_encryption_key
Free · Read-only
Verifys encryption key.

Device statistics

ToolWhat it does
cove_get_common_statistics_by_token
Free · Read-only
Returns common statistics by token.
cove_list_account_statistics
Free · Read-only
The backup statistics grid: one row per device with the columns you ask for (Cove column codes such as AN device name, AU, AR), filtered, ordered and paged.
cove_update_statistics
Pro · Destructive
DESTRUCTIVE.

Labels, custom columns and profiles

ToolWhat it does
cove_add_account_label
Pro · Write
Adds account label.
cove_add_account_profile
Pro · Destructive
DESTRUCTIVE.
cove_add_custom_column
Pro · Write
Adds custom column.
cove_add_labels
Pro · Write
Adds labels.
cove_get_account_custom_column_values
Free · Read-only
Returns account custom column values.
cove_get_account_profile_info
Free · Read-only
Returns account profile info.
cove_get_custom_column_info_by_id
Free · Read-only
Returns custom column info by id.
cove_list_account_ids_by_label
Free · Read-only
Lists account ids by label.
cove_list_account_labels_by_account_id
Free · Read-only
Lists account labels by account id.
cove_list_account_labels_by_account_ids
Free · Read-only
Lists account labels by account ids.
cove_list_account_labels_by_names
Free · Read-only
Lists account labels by names.
cove_list_account_profiles
Free · Read-only
Lists account profiles.
cove_list_all_labels
Free · Read-only
Lists all labels.
cove_list_columns
Free · Read-only
Lists columns.
cove_list_custom_columns
Free · Read-only
Lists custom columns.
cove_modify_account_profile
Pro · Destructive
DESTRUCTIVE.
cove_modify_custom_column
Pro · Write
Changes custom column.
cove_remove_account_label
Pro · Destructive
DESTRUCTIVE.
cove_remove_account_profile
Pro · Destructive
DESTRUCTIVE.
cove_remove_custom_column
Pro · Destructive
DESTRUCTIVE.
cove_remove_labels
Pro · Destructive
DESTRUCTIVE.
cove_update_account_custom_column_values
Pro · Write
Updates account custom column values.

Users and roles

ToolWhat it does
cove_add_invitation_link
Pro · Destructive
DESTRUCTIVE.
cove_add_user
Pro · Destructive
DESTRUCTIVE.
cove_add_user_settings
Pro · Write
Adds user settings.
cove_get_partner_users_login_times
Free · Read-only
Returns partner users login times.
cove_get_respect_removed_user_info_by_id
Free · Read-only
Returns respect removed user info by id.
cove_get_user_info
Free · Read-only
Returns user info.
cove_get_user_info_by_id
Free · Read-only
Returns user info by id.
cove_get_user_passport
Pro · Destructive
DESTRUCTIVE.
cove_get_user_settings
Free · Read-only
Returns user settings.
cove_list_partner_users_login_times
Free · Read-only
Lists partner users login times.
cove_list_user_roles
Free · Read-only
Lists user roles.
cove_list_user_settings
Free · Read-only
Lists user settings.
cove_list_users
Free · Read-only
Lists the users of the given customers (partners).
cove_list_users_by_filter
Free · Read-only
Lists users by filter.
cove_list_users_with_security_officer_flag
Free · Read-only
Lists users with security officer flag.
cove_modify_user
Pro · Destructive
DESTRUCTIVE.
cove_modify_user_on_login
Pro · Destructive
DESTRUCTIVE.
cove_modify_user_settings
Pro · Write
Changes user settings.
cove_remove_user
Pro · Destructive
DESTRUCTIVE.
cove_remove_user_settings
Pro · Destructive
DESTRUCTIVE.
cove_send_user_invitation
Pro · Destructive
DESTRUCTIVE.
cove_set_current_user_settings
Pro · Write
Sets current user settings.

Contacts and notes

ToolWhat it does
cove_add_contact_note
Pro · Write
Adds contact note.
cove_add_contact_person
Pro · Destructive
DESTRUCTIVE.
cove_get_contact_note_info
Free · Read-only
Returns contact note info.
cove_get_contact_person_info_by_id
Free · Read-only
Returns contact person info by id.
cove_list_all_contact_persons
Free · Read-only
Lists all contact persons.
cove_list_contact_notes
Free · Read-only
Lists contact notes.
cove_list_contact_persons
Free · Read-only
Lists contact persons.
cove_list_last_contact_notes
Free · Read-only
Lists last contact notes.
cove_modify_contact_note
Pro · Write
Changes contact note.
cove_modify_contact_person
Pro · Destructive
DESTRUCTIVE.
cove_remove_contact_note
Pro · Destructive
DESTRUCTIVE.
cove_remove_contact_person
Pro · Destructive
DESTRUCTIVE.

Notifications and report delivery

ToolWhat it does
cove_add_notification_rule
Pro · Destructive
DESTRUCTIVE.
cove_add_notification_template
Pro · Destructive
DESTRUCTIVE.
cove_add_notification_transport
Pro · Destructive
DESTRUCTIVE.
cove_add_view_delivery
Pro · Destructive
DESTRUCTIVE.
cove_enable_notification_rule
Pro · Destructive
DESTRUCTIVE.
cove_get_amazon_endpoint_for_email
Free · Read-only
Returns amazon endpoint for email.
cove_get_notification_rule
Free · Read-only
Returns notification rule.
cove_get_notification_template
Free · Read-only
Returns notification template.
cove_get_notification_transport
Free · Read-only
Returns notification transport.
cove_get_partner_notification_template
Free · Read-only
Returns partner notification template.
cove_get_view_delivery_external_recipients_states
Free · Read-only
Returns view delivery external recipients states.
cove_get_view_delivery_info_by_id
Free · Read-only
Returns view delivery info by id.
cove_get_view_delivery_recipients_states
Free · Read-only
Returns view delivery recipients states.
cove_is_view_delivery_enabled
Free · Read-only
Returns whether view delivery enabled.
cove_list_all_active_notification_rules
Free · Read-only
Lists all active notification rules.
cove_list_all_inactive_notification_rules
Free · Read-only
Lists all inactive notification rules.
cove_list_all_notification_rules
Free · Read-only
Lists all notification rules.
cove_list_all_notification_transports
Free · Read-only
Lists all notification transports.
cove_list_notification_rules
Free · Read-only
Lists notification rules.
cove_list_notification_transports
Free · Read-only
Lists notification transports.
cove_list_templates
Free · Read-only
Lists templates.
cove_list_unsubscribed_emails
Free · Read-only
Lists unsubscribed emails.
cove_list_view_deliveries
Free · Read-only
Lists view deliveries.
cove_lookup_transport
Free · Read-only
Looks up transport.
cove_modify_notification_rule
Pro · Destructive
DESTRUCTIVE.
cove_modify_notification_template
Pro · Destructive
DESTRUCTIVE.
cove_modify_notification_transport
Pro · Destructive
DESTRUCTIVE.
cove_modify_view_delivery
Pro · Destructive
DESTRUCTIVE.
cove_opt_in_view_delivery
Pro · Destructive
DESTRUCTIVE.
cove_perform_view_delivery
Pro · Destructive
DESTRUCTIVE.
cove_register_email
Pro · Destructive
DESTRUCTIVE.
cove_remove_notification_rule
Pro · Destructive
DESTRUCTIVE.
cove_remove_notification_template
Pro · Destructive
DESTRUCTIVE.
cove_remove_notification_transport
Pro · Destructive
DESTRUCTIVE.
cove_remove_view_delivery
Pro · Destructive
DESTRUCTIVE.
cove_unregister_email
Pro · Destructive
DESTRUCTIVE.
cove_unsubscribe_email_from_rule
Pro · Destructive
DESTRUCTIVE.
cove_unsubscribe_view_delivery
Pro · Destructive
DESTRUCTIVE.

Storage and locations

ToolWhat it does
cove_add_account_node
Pro · Destructive
DESTRUCTIVE.
cove_add_location
Pro · Destructive
DESTRUCTIVE.
cove_add_region
Pro · Destructive
DESTRUCTIVE.
cove_add_storage
Pro · Destructive
DESTRUCTIVE.
cove_add_storage_node
Pro · Destructive
DESTRUCTIVE.
cove_get_account_node_info
Free · Read-only
Returns account node info.
cove_get_account_node_info_by_guid
Free · Read-only
Returns account node info by guid.
cove_get_location_info
Free · Read-only
Returns location info.
cove_get_location_info_by_name
Free · Read-only
Returns location info by name.
cove_get_reserved_storage
Free · Read-only
Returns reserved storage.
cove_get_storage_info
Free · Read-only
Returns storage info.
cove_get_storage_info_by_name
Free · Read-only
Returns storage info by name.
cove_get_storage_node_info
Free · Read-only
Returns storage node info.
cove_get_storage_node_info_by_name
Free · Read-only
Returns storage node info by name.
cove_get_storage_node_update_info
Free · Read-only
Returns storage node update info.
cove_list_account_nodes_by_account_token
Free · Read-only
Lists account nodes by account token.
cove_list_all_storage_nodes
Free · Read-only
Lists all storage nodes.
cove_list_ever_hosted_accounts
Free · Read-only
Lists ever hosted accounts.
cove_list_locations
Free · Read-only
Lists the data-center locations backup data can be stored in.
cove_list_regions
Free · Read-only
Lists regions.
cove_list_software_only_ancestral_partners_storages
Free · Read-only
Lists software only ancestral partners storages.
cove_list_storage_nodes
Free · Read-only
Lists storage nodes.
cove_list_storage_nodes_by_account_id
Free · Read-only
Lists storage nodes by account id.
cove_list_storage_nodes_with_environments
Free · Read-only
Lists storage nodes with environments.
cove_list_storage_statistics
Free · Read-only
Lists storage statistics.
cove_list_storages
Free · Read-only
Lists a customer's storages (where backup data is kept).
cove_modify_storage
Pro · Destructive
DESTRUCTIVE.
cove_relocate_account_node_by_token
Pro · Destructive
DESTRUCTIVE.
cove_remove_storage
Pro · Destructive
DESTRUCTIVE.
cove_remove_storage_node
Pro · Destructive
DESTRUCTIVE.
cove_resolve_storage_node_executor
Free · Read-only
Resolves storage node executor.
cove_return_account_to_home_location
Pro · Destructive
DESTRUCTIVE.
cove_update_storage_node
Pro · Destructive
DESTRUCTIVE.
cove_update_storage_node_mode
Pro · Destructive
DESTRUCTIVE.

Jobs

ToolWhat it does
cove_add_root_job
Pro · Destructive
DESTRUCTIVE.
cove_control_job
Pro · Destructive
DESTRUCTIVE.
cove_get_job_by_id
Free · Read-only
Returns job by id.
cove_list_jobs
Free · Read-only
Lists a customer's jobs (data moves, deletions, node changes).
cove_list_jobs_by_ids
Free · Read-only
Lists jobs by ids.
cove_list_jobs_by_parent_id
Free · Read-only
Lists jobs by parent id.

Products, features and pricing

ToolWhat it does
cove_add_product
Pro · Destructive
DESTRUCTIVE.
cove_find_product_by_name
Free · Read-only
Finds product by name.
cove_get_account_features
Free · Read-only
Returns account features.
cove_get_partner_price_currency
Free · Read-only
Returns partner price currency.
cove_get_partner_production_dates
Free · Read-only
Returns partner production dates.
cove_get_product_info
Free · Read-only
Returns product info.
cove_get_product_info_with_extra_features
Free · Read-only
Returns product info with extra features.
cove_list_end_customer_prices
Free · Read-only
Lists end customer prices.
cove_list_features
Free · Read-only
Lists features.
cove_list_products
Free · Read-only
Lists the products (licence bundles) a customer can sell or use.
cove_modify_product
Pro · Destructive
DESTRUCTIVE.
cove_remove_product
Pro · Destructive
DESTRUCTIVE.
cove_reset_features_restrictions
Pro · Destructive
DESTRUCTIVE.
cove_set_account_features
Pro · Destructive
DESTRUCTIVE.
cove_set_end_customer_price
Pro · Destructive
DESTRUCTIVE.
cove_set_partner_price_currency
Pro · Destructive
DESTRUCTIVE.

Audit, permissions and personal data

ToolWhat it does
cove_list_audit_action_entity_types
Free · Read-only
Lists audit action entity types.
cove_list_audit_action_operation_types
Free · Read-only
Lists audit action operation types.
cove_list_audit_action_result_types
Free · Read-only
Lists audit action result types.
cove_list_audit_actions
Free · Read-only
Lists the audit trail of actions performed in the console and API between two Unix times, up to a count limit.
cove_list_permissions
Free · Read-only
Lists permissions.
cove_remove_personal_data
Pro · Destructive
DESTRUCTIVE.

Branding and agreements

ToolWhat it does
cove_accept_eula
Pro · Destructive
DESTRUCTIVE.
cove_decline_eula
Pro · Destructive
DESTRUCTIVE.
cove_find_branding
Free · Read-only
Finds branding.
cove_get_common_eula_info
Free · Read-only
Returns common eula info.
cove_get_effective_partner_branding
Free · Read-only
Returns effective partner branding.
cove_get_end_customer_eula_state
Free · Read-only
Returns end customer eula state.
cove_get_eula_info
Free · Read-only
Returns eula info.
cove_get_partner_branding
Free · Read-only
Returns partner branding.
cove_get_partner_eula_info
Free · Read-only
Returns partner eula info.
cove_get_partner_web_branding
Free · Read-only
Returns partner web branding.
cove_reset_branding
Pro · Destructive
DESTRUCTIVE.
cove_set_branding
Pro · Destructive
DESTRUCTIVE.
cove_set_partner_branding
Pro · Destructive
DESTRUCTIVE.
cove_set_partner_web_branding
Pro · Destructive
DESTRUCTIVE.

Server and reference data

ToolWhat it does
cove_get_country_by_iso_code
Free · Read-only
Returns country by iso code.
cove_get_country_by_iso_code_or_name
Free · Read-only
Returns country by iso code or name.
cove_get_country_by_name
Free · Read-only
Returns country by name.
cove_get_effective_environment_info
Free · Read-only
Returns the environment settings in effect for the signed-in user.
cove_get_server_info
Free · Read-only
Returns the Management Service's own version and build information.
cove_list_countries
Free · Read-only
Lists the countries Cove knows (name and ISO code).