Harness

Harness Account Template API

This contains APIs for Account-scoped Templates.

GitHub OpenAPI

Operations 10

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

POST /v1/templates Create an account-level template · Create Template #
Ask an LLM
“How do I publish a reusable pipeline or step template for the whole account?”
“Can I mark a new account template version as stable when I create it?”
Tell an agent
Create an account template from YAML {template_yaml}.
Create account template {name} with version label {label} and mark it stable {is_stable}.
GET /v1/templates List account-level templates · Get Templates List #
Ask an LLM
“What templates are defined at the account level?”
“Can I filter account templates by entity type or search by name?”
Tell an agent
List account templates matching {search_term}.
Show account-scope templates of entity type {entity_types}.
PUT /v1/templates/git-metadata/{template} Update Git details for a template's versions · Update Git details #
Ask an LLM
“Can I update the Git metadata for all versions of a template at once?”
“How do I fix a template's Git details after its repo moved?”
Tell an agent
Update Git details across versions of template {template}.
Refresh the Git metadata stored for account template {template}.
GET /v1/templates/{template} Get the stable version of a template · Get Stable Template #
Ask an LLM
“Which version of an account template is currently marked stable?”
“Can I get the stable template's YAML from a specific Git branch?”
Tell an agent
Get the stable version of account template {template}.
Fetch stable template {template} with YAML from branch {branch_name}.
GET /v1/templates/{template}/versions/{version} Get a specific template version · Retrieve a Template #
Ask an LLM
“How do I retrieve a particular version label of an account template?”
“Can I include the YAML when fetching one template version?”
Tell an agent
Get version {version} of account template {template}.
Show template {template} at version {version} including YAML.
PUT /v1/templates/{template}/versions/{version} Update a template version · Update Template #
Ask an LLM
“Can I edit the YAML of one existing template version?”
“How do I add a change comment when updating an account template?”
Tell an agent
Update version {version} of template {template} with YAML {template_yaml}.
Change the description of template {template} version {version} to {description}.
DELETE /v1/templates/{template}/versions/{version} Delete a template version · Delete Template #
Ask an LLM
“How do I delete one version of an account template?”
“Can I force-delete a template version that pipelines still reference?”
Tell an agent destructive · confirm first
Delete version {version} of account template {template}.
Force-delete template {template} version {version} with comment {comments}.
PUT /v1/templates/{template}/versions/{version}/stable Mark a template version as stable · Update Stable Template #
Ask an LLM
“How do I promote a template version to be the stable one?”
“Which version do pipelines pick up after I change the stable template?”
Tell an agent
Make version {version} the stable version of template {template}.
Promote template {template} version {version} to stable with note {comments}.
POST /v1/templates/{template}/import Import an account template from Git · Import Template #
Ask an LLM
“Can I import a template that already lives in a Git repo into my account?”
“What Git details do I need to import a template?”
Tell an agent
Import template {template} into the account from Git using {git_import_details}.
Pull account template {template} in from its repository.
GET /v1/templates/{template}/versions/{version}/inputs-schema Get the inputs schema of a template · Get inputs schema for account level templates #
Ask an LLM
“What runtime inputs does an account template version expect?”
“Is there a schema describing an account template's inputs?”
Tell an agent
Get the inputs schema for template {template} version {version}.
Show which inputs account template {template} at {version} requires.

Documentation

📖
Documentation
https://apidocs.harness.io
📖
APIReference
https://apidocs.harness.io
📖
GettingStarted
https://developer.harness.io/docs/platform/automation/api/api-quickstart/
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/authentication/harness-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/rate-limits/harness-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/openapi/harness-account-template-api-openapi.yml

Other Resources

🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/scopes/harness-scopes.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/errors/harness-error-codes.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/conventions/harness-conventions.yml
🔗
Idempotency
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/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-account-template-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.

GitHub Google LinkedIn

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

OpenAPI Specification

harness-account-template-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Harness Account Template 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 (65 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/openapi/harness-account-template-api-openapi.yml