Harness

Harness Downtime API

This contains APIs related to CRUD operations of Downtime

GitHub OpenAPI

Operations 9

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 /cv/api/account/{accountIdentifier}/org/{orgIdentifier}/project/{projectIdentifier}/downtime/identifier/{identifier} Get a scheduled downtime · Get downtime #
Ask an LLM
“What window and services does a particular monitoring downtime cover?”
“Can I see the full definition of one downtime?”
Tell an agent
Show downtime {identifier} in account {accountIdentifier}, org {orgIdentifier}, project {projectIdentifier}.
Get the schedule of downtime {identifier} in project {projectIdentifier}.
PUT /cv/api/account/{accountIdentifier}/org/{orgIdentifier}/project/{projectIdentifier}/downtime/identifier/{identifier} Edit a downtime's schedule and scope · Update downtime data #
Ask an LLM
“How do I change the schedule or affected services of an existing downtime?”
“Can I rename a downtime or change its category after it's saved?”
Tell an agent
Update downtime {identifier} in account {accountIdentifier}, org {orgIdentifier}, project {projectIdentifier} with new spec {spec}.
Rename downtime {identifier} to {name} and set its category to {category}.
DELETE /cv/api/account/{accountIdentifier}/org/{orgIdentifier}/project/{projectIdentifier}/downtime/identifier/{identifier} Delete a downtime · Delete downtime data #
Ask an LLM
“Can I delete a maintenance downtime that's no longer needed?”
“What's the way to remove a downtime entirely rather than disabling it?”
Tell an agent destructive · confirm first
Delete downtime {identifier} in account {accountIdentifier}, org {orgIdentifier}, project {projectIdentifier}.
Remove the downtime {identifier} permanently.
GET /cv/api/account/{accountIdentifier}/org/{orgIdentifier}/project/{projectIdentifier}/downtime/monitored-services/{identifier} List services covered by one downtime · Get associated monitored services #
Ask an LLM
“Which monitored services are silenced by a specific downtime?”
“Does this downtime affect our checkout service?”
Tell an agent
List the monitored services covered by downtime {identifier} in account {accountIdentifier}, org {orgIdentifier}, project {projectIdentifier}.
Show which services downtime {identifier} applies to.
GET /cv/api/account/{accountIdentifier}/org/{orgIdentifier}/project/{projectIdentifier}/downtime/monitored-services List all services that have downtimes · Get downtime associated monitored services #
Ask an LLM
“Which monitored services in this project have any downtime attached?”
“Can I page through every service that's tied to a downtime?”
Tell an agent
List every monitored service with a downtime in account {accountIdentifier}, org {orgIdentifier}, project {projectIdentifier}.
Show page {pageNumber} of services that have downtimes in project {projectIdentifier}.
GET /cv/api/account/{accountIdentifier}/org/{orgIdentifier}/project/{projectIdentifier}/downtime/history Show past downtime occurrences · Get history #
Ask an LLM
“When did downtimes last run for a service, and how long did they last?”
“Can I filter downtime history by name or by monitored service?”
Tell an agent
Show downtime history for account {accountIdentifier}, org {orgIdentifier}, project {projectIdentifier}.
List past downtimes that affected monitored service {monitoredServiceIdentifier}.
GET /cv/api/account/{accountIdentifier}/org/{orgIdentifier}/project/{projectIdentifier}/downtime/list List configured downtimes · List downtimes #
Ask an LLM
“What downtimes are currently configured in my project?”
“Can I search downtimes by name?”
Tell an agent
List the downtimes configured in account {accountIdentifier}, org {orgIdentifier}, project {projectIdentifier}.
Find configured downtimes named like {filter} for service {monitoredServiceIdentifier}.
POST /cv/api/account/{accountIdentifier}/org/{orgIdentifier}/project/{projectIdentifier}/downtime Schedule a new downtime · Save downtime #
Ask an LLM
“How do I schedule a maintenance window so alerts and SLOs pause for some services?”
“Can a downtime be recurring rather than one-time?”
Tell an agent
Create downtime {name} ({identifier}) of category {category} in account {accountIdentifier}, org {orgIdentifier}, project {projectIdentifier}.
Schedule downtime {name} with schedule {spec} for services {entitiesRule}.
PUT /cv/api/account/{accountIdentifier}/org/{orgIdentifier}/project/{projectIdentifier}/downtime/flag/{identifier} Enable or disable a downtime · Update downtime enabled #
Ask an LLM
“Can I temporarily turn off a downtime without deleting it?”
“Is there a quick toggle to re-enable a paused downtime?”
Tell an agent
Set downtime {identifier} in account {accountIdentifier}, org {orgIdentifier}, project {projectIdentifier} to enabled={enable}.
Disable downtime {identifier} by setting its flag to {enable}.

Documentation

📖
Documentation
https://apidocs.harness.io
📖
APIReference
https://apidocs.harness.io
📖
GettingStarted
https://developer.harness.io/docs/platform/automation/api/api-quickstart/
📖
Authentication
https://artifacts.apis.io/harness/authentication/harness-authentication.yml
📖
RateLimits
https://artifacts.apis.io/harness/rate-limits/harness-rate-limits.yml

Specifications

⚙
OpenAPI
https://artifacts.apis.io/harness/openapi/harness-downtime-api-openapi.yml

Other Resources

🔗
OAuthScopes
https://artifacts.apis.io/harness/scopes/harness-scopes.yml
🔗
ErrorCatalog
https://artifacts.apis.io/harness/errors/harness-error-codes.yml
🔗
Conventions
https://artifacts.apis.io/harness/conventions/harness-conventions.yml
🔗
Idempotency
https://artifacts.apis.io/harness/conventions/harness-conventions.yml

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/harness:harness-downtime-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

GitHub Google LinkedIn

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

OpenAPI Specification

harness-downtime-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Harness Downtime API
  version: '1.0'
  description: The Harness Software Delivery Platform uses OpenAPI Specification v3.0.
  contact:
    name: API Support
    email: contact@harness.io
    url: https://harness.io/
  x-logo:
    url: https://mma.prnewswire.com/media/779232/Harnes_logo_horizontal.jpg?p=facebook
    altText: Harness
  termsOfService: https://harness.io/terms-of-use/
servers:
- url: https://app.harness.io
  description: Harness host URL
- url: https://{vanity}
  description: Vanity URL
  variables:
    vanity:
      default: app.harness.io
security:
- x-api-key: []
tags:


# --- truncated at 32 KB (73 KB total) ---
# Full source: https://artifacts.apis.io/harness/openapi/harness-downtime-api-openapi.yml