Cohesity Protection Groups API

The Protection Groups API from Cohesity — 11 operation(s) for protection groups.

Business capability
Disaster Recovery Management BC-160.20

Operations 16

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /data-protect/protection-groups List protection groups · Get the list of Protection Groups #
Ask an LLM
“Which protection groups had their last backup fail?”
“Can I list only paused protection groups, or only those with a DataLock?”
Tell an agent
List protection groups named {names}.
Show protection groups using policy {policyIds} with last run info.
POST /data-protect/protection-groups Create a protection group · Create a Protection Group #
Ask an LLM
“How do I set up a new backup group for my VMware VMs with a given policy?”
“Can I create a protection group that starts paused?”
Tell an agent
Create protection group {name} for {environment} using policy {policyId}.
Create a paused {environment} protection group {name} on policy {policyId} writing to storage domain {storageDomainId}.
POST /data-protect/protection-groups/states Pause, resume or deactivate protection groups in bulk · Perform an action like pause, resume, active, deactivate on all specified… #
Ask an LLM
“Can I pause several backup groups at once during a maintenance window?”
“When does resuming a protection group take effect?”
Tell an agent
Apply action {action} to protection groups {ids}.
Pause protection groups {ids}.
GET /data-protect/protection-groups/{id} Get a protection group · List details about single Protection Group #
Ask an LLM
“How do I look at a single protection group's configuration and last run?”
“What policy and storage domain is a given backup group using?”
Tell an agent
Get protection group {id}.
Show protection group {id} with its last run info.
PUT /data-protect/protection-groups/{id} Update a protection group's settings · Update a Protection Group #
Ask an LLM
“Can I switch an existing protection group to a different policy?”
“How do I change the start time or priority of a backup group?”
Tell an agent
Update protection group {id} to use policy {policyId}.
Rename protection group {id} to {name}, keeping environment {environment} and policy {policyId}.
DELETE /data-protect/protection-groups/{id} Delete a protection group · Delete a Protection Group #
Ask an LLM
“If I delete a backup group, are its snapshots kept?”
“How do I remove a protection group and its snapshots too?”
Tell an agent destructive · confirm first
Delete protection group {id}.
Delete protection group {id} and its snapshots.
GET /data-protect/protection-groups/{id}/runs List runs of a protection group · Get the list of runs for a Protection Group #
Ask an LLM
“What were the last backup runs for one protection group and did they succeed?”
“Can I exclude runs that can't be restored from a group's run history?”
Tell an agent
List runs for protection group {id}.
Show the last {numRuns} runs of protection group {id}.
PUT /data-protect/protection-groups/{id}/runs Change retention or resync runs of a group · Update runs for a particular Protection Group #
Ask an LLM
“Can I extend how long snapshots from a past backup run are kept?”
“How do I retry failed replication copies for an earlier run?”
Tell an agent
Update runs of protection group {id} with {updateProtectionGroupRunParams}.
Extend retention on runs of group {id} using {updateProtectionGroupRunParams}.
POST /data-protect/protection-groups/{id}/runs Start an on-demand backup run · Create a new protection run #
Ask an LLM
“How do I kick off a backup right now instead of waiting for the schedule?”
“Can I run a full backup on demand for just a few objects in a group?”
Tell an agent
Run protection group {id} now as a {runType} backup.
Start a {runType} run of group {id} for objects {objects}.
GET /data-protect/protection-groups/{id}/runs/{runId} Get a single protection group run · Get a run for a Protection Group #
Ask an LLM
“How do I check the result of one specific backup run?”
“Can I see object-level details for a particular run?”
Tell an agent
Get run {runId} of protection group {id}.
Show object details for run {runId} in group {id}.
POST /data-protect/protection-groups/{id}/runs/{runId}/cancel Cancel a running backup · Cancel protection group run #
Ask an LLM
“Can I stop a backup run that's taking too long?”
“Is it possible to cancel only the replication part of a run?”
Tell an agent destructive · confirm first
Cancel run {runId} of protection group {id}.
Cancel the replication task {replicationTaskId} in run {runId} of group {id}.
GET /data-protect/protection-groups/{id}/runs/{runId}/debug-logs Download debug logs for a backup run · Get the debug logs for a run from a Protection Group #
Ask an LLM
“Where can I get the debug logs for all objects in a failed run?”
“Can I narrow a run's debug logs to one object?”
Tell an agent
Get debug logs for run {runId} of group {id}.
Get run {runId} debug logs from group {id} filtered to object {objectId}.
GET /data-protect/protection-groups/{id}/runs/{runId}/objects/{objectId}/debug-logs Get debug logs for one object in a run · Get the debug logs for a particular object in a run from a Protection Group #
Ask an LLM
“How do I pull debug logs for just one VM that failed in a backup run?”
“Is there an object-specific debug log endpoint for a run?”
Tell an agent
Get debug logs for object {objectId} in run {runId} of group {id}.
Download the per-object debug log for {objectId}, run {runId}, group {id}.
GET /data-protect/protection-groups/{id}/runs/{runId}/objects/{objectId}/downloadMessages Download a CSV of run errors for an object · Get the CSV of errors/warnings for a given run and an object #
Ask an LLM
“Can I get a CSV listing file paths that errored during a backup of one object?”
“What warnings did a run hit for a specific object, file by file?”
Tell an agent
Download the error and warning CSV for object {objectId} in run {runId} of group {id}.
Get the file-level error report for object {objectId}, run {runId}, group {id}.
GET /data-protect/runs/summary Summarize runs across all groups · Get the list of runs #
Ask an LLM
“Which backup runs failed across all protection groups yesterday?”
“Can I get a cluster-wide summary of runs in a time window?”
Tell an agent
List protection runs with status {runStatus}.
Summarize all runs between {startTimeUsecs} and {endTimeUsecs}.
GET /data-protect/runs/{runId}/progress Track progress of a run · Get the progress of a run #
Ask an LLM
“How far along is a backup run that's currently in progress?”
“Can I include finished tasks and event logs in a run's progress?”
Tell an agent
Show the progress of run {runId}.
Get progress for run {runId} including finished tasks and event logs.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/cohesity:cohesity-protection-groups-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cohesity-protection-groups-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  description: Cohesity API provides a RESTful interface to access the various data management operations on Cohesity cluster and Helios.
  title: Cohesity REST Protection Groups API
  version: '2.0'
servers:
- url: /v2
tags:


# --- truncated at 32 KB (157 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cohesity/refs/heads/main/openapi/cohesity-protection-groups-api-openapi.yml