Harness

Harness Org Template API

This contains APIs for Organization-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

PUT /v1/orgs/{org}/templates/git-metadata/{template} Update Git details of an org template · Update Git details #
Ask an LLM
“Can I update the Git metadata for all versions of an org-level template?”
“What's the call to change Git details on a template stored in my organization?”
Tell an agent
Update the Git details of template {template} in org {org}.
Refresh Git metadata across every version of org template {template} in {org}.
POST /v1/orgs/{org}/templates Create an organization-level template · Create Template #
Ask an LLM
“How do I create a new template shared across an organization?”
“Can I mark a newly created org template as the stable version?”
Tell an agent
Create template {name} in org {org} from this YAML: {yaml}
Create org {org} template {identifier} labeled {label} as the stable version.
GET /v1/orgs/{org}/templates List templates in an organization · Get Templates List #
Ask an LLM
“Which pipeline templates exist at my organization level?”
“Can I filter org templates by type or search term?”
Tell an agent
List templates in org {org}.
Search org {org} templates of type {type} for {term}.
GET /v1/orgs/{org}/templates/{template} Get the stable version of an org template · Get Stable Template #
Ask an LLM
“What is the current stable version of an org template?”
“Can I fetch a stable org template's YAML from a specific Git branch?”
Tell an agent
Get the stable version of template {template} in org {org}.
Get the stable org template {template} in {org} with YAML from branch {branch}.
GET /v1/orgs/{org}/templates/{template}/versions/{version} Get a specific version of an org template · Retrieve a Template #
Ask an LLM
“Can I retrieve an older version of an org-level template?”
“What does version label X of my organization template contain?”
Tell an agent
Get version {version} of template {template} in org {org}.
Show the YAML of org {org} template {template} at version {version}.
PUT /v1/orgs/{org}/templates/{template}/versions/{version} Update a version of an org template · Update Template #
Ask an LLM
“How do I edit a specific version of an org template?”
“Can I change the YAML of one template version without touching others?”
Tell an agent
Update version {version} of org template {template} in {org} with this YAML: {yaml}
Rename version {version} of template {template} in org {org} to {name}.
DELETE /v1/orgs/{org}/templates/{template}/versions/{version} Delete a version of an org template · Delete Template #
Ask an LLM
“Can I delete one version of an organization template?”
“Is there a force option when deleting an org template version that's in use?”
Tell an agent destructive · confirm first
Delete version {version} of template {template} in org {org}.
Force delete version {version} of org template {template} in {org} with comment {comments}.
PUT /v1/orgs/{org}/templates/{template}/versions/{version}/stable Set the stable version of an org template · Update Stable Template #
Ask an LLM
“How do I promote a template version to stable at the org level?”
“Can I switch which version of an org template is marked stable?”
Tell an agent
Mark version {version} of template {template} in org {org} as stable.
Promote org {org} template {template} version {version} to stable with comment {comments}.
POST /v1/orgs/{org}/templates/{template}/import Import an org template from Git · Import template #
Ask an LLM
“Can I import a template that already lives in a Git repo into my organization?”
“What details are needed to import a template at the org level?”
Tell an agent
Import template {template} into org {org} from Git.
Import org template {template} into {org} using Git details {git}.
GET /v1/orgs/{org}/templates/{template}/versions/{version}/inputs-schema Get the inputs schema of an org template · Get inputs schema for org level templates #
Ask an LLM
“Which runtime inputs does an org template version expect?”
“Can I get the input schema for an organization-level template?”
Tell an agent
Get the inputs schema for version {version} of template {template} in org {org}.
Show the runtime inputs org {org} 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-org-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-org-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-org-template-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Harness Org 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-org-template-api-openapi.yml