Harness

Harness Services API

This contains APIs related to Services

Documentation GitHub OpenAPI

Operations 17

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 /ng/api/servicesV2/check-allowed-values Check services for allowed-values usage · Check for allowed-values in the Services #

Ask an LLM

“Do any of my Harness services use allowed-values in their inputs?”

“Can I check services for allowed-values constraints across an account?”

Tell an agent

Check the services in account {accountIdentifier} for allowed-values.

Scan services for allowed-values usage in account {accountIdentifier}.

GET /ng/api/servicesV2 List deployment services · Gets Service list #

Ask an LLM

“What deployment services are defined in my project?”

“Can I filter services by deployment type, tags or GitOps enabled?”

Tell an agent

List the services in project {projectIdentifier} of account {accountIdentifier}.

Find services named like {searchTerm} with deployment type {type}.

PUT /ng/api/servicesV2 Update an existing service · Update a Service by identifier #

Ask an LLM

“How do I change the YAML or description of an existing service?”

“Can I commit a service update to a Git branch at the same time?”

Tell an agent

Update service {identifier} with this YAML: {yaml}

Rename existing service {identifier} to {name} in account {accountIdentifier}.

POST /ng/api/servicesV2 Create a single service · Create a Service #

Ask an LLM

“How do I create a new deployment service in a Harness project?”

“What do I need to define a service from YAML?”

Tell an agent

Create a new service {name} with identifier {identifier} in project {projectIdentifier}.

Define one new service in account {accountIdentifier} from YAML {yaml}.

POST /ng/api/servicesV2/batch Create several services in one batch · Create Services #

Ask an LLM

“Can I create many services in a single request?”

“Is there a bulk endpoint for adding services all at once?”

Tell an agent

Batch-create these services in account {accountIdentifier}.

Add all of the following services together to account {accountIdentifier}.

POST /ng/api/servicesV2/batch/partial Batch-create services allowing partial success · Create Services with partial success support - returns both successful and… #

Ask an LLM

“What happens if some services in a batch fail to create?”

“Can I get back both the created and the failed services from a bulk create?”

Tell an agent

Create these services in account {accountIdentifier} and report which ones failed.

Run a partial-success service batch in account {accountIdentifier}.

GET /ng/api/servicesV2/{serviceIdentifier} Get a service by identifier · Gets a Service by identifier #

Ask an LLM

“What is the definition of one specific service?”

“Can I look up a deleted service by its identifier?”

Tell an agent

Get service {serviceIdentifier} in account {accountIdentifier}.

Show the YAML of service {serviceIdentifier} in project {projectIdentifier}.

DELETE /ng/api/servicesV2/{serviceIdentifier} Delete a service · Delete a Service by identifier #

Ask an LLM

“How do I delete a service I no longer deploy?”

“Can I force-delete a service that is still referenced?”

Tell an agent destructive · confirm first

Delete service {serviceIdentifier} from account {accountIdentifier}.

Force-delete service {serviceIdentifier} in project {projectIdentifier}.

GET /ng/api/servicesV2/k8s/command-flags List Kubernetes command flag options · Retrieving the list of Kubernetes Command Options #

Ask an LLM

“Which Kubernetes command flags can I set on a service step?”

“What kubectl command options are supported for a given step type?”

Tell an agent

List the Kubernetes command flags for service spec type {serviceSpecType}.

Show K8s command options for step type {stepType} on spec type {serviceSpecType}.

GET /ng/api/servicesV2/kustomize/command-flags List Kustomize command flags · Retrieving the list of Kustomize Command Flags #

Ask an LLM

“Which Kustomize command flags does Harness support for services?”

“What Kustomize build options can I pass in a service?”

Tell an agent

List the available Kustomize command flags.

Show me the supported Kustomize build options for services.

GET /ng/api/servicesV2/plugin-info Get plugin info for services · Get Plugin Info at Service #

Ask an LLM

“What plugin information is available at the service level?”

“Which plugins can a service use?”

Tell an agent

Get the service-level plugin info.

Show me plugin details for services.

GET /ng/api/servicesV2/hooks/actions List actions available for service hooks · Retrieving the list of actions available for service hooks #

Ask an LLM

“What actions can a service hook run on?”

“Which hook actions apply to a given service spec type?”

Tell an agent

List service hook actions for spec type {serviceSpecType}.

Show which hook actions are available to {serviceSpecType} services.

POST /ng/api/servicesV2/import Import a service YAML from a Git repository · Get Service YAML from Git Repository #

Ask an LLM

“How do I import a service definition that lives in Git?”

“Can I force an import of a service YAML from a repo branch?”

Tell an agent

Import the service at {filePath} on branch {branch} of repo {repoName}.

Pull service YAML from {repoName} branch {branch} file {filePath} into account {accountIdentifier}.

GET /ng/api/servicesV2/list/access List services I have access to · Gets Service Access list #

Ask an LLM

“Which services do I have access permissions for?”

“Can I get the service access list including services accessible at a scope?”

Tell an agent

Get the service access list for account {accountIdentifier}.

Show accessible services matching {searchTerm} in project {projectIdentifier}.

POST /ng/api/servicesV2/move-config/{serviceIdentifier} Move a service YAML from inline to Git · Move Service YAML from inline to remote #

Ask an LLM

“How do I move an inline service definition into a Git repo?”

“Can I store a service's YAML remotely on a new branch?”

Tell an agent

Move service {serviceIdentifier} to Git repo {repoName} at {filePath}.

Convert inline service {serviceIdentifier} to remote on branch {branch}.

PUT /ng/api/servicesV2/{serviceIdentifier}/update-git-metadata Update Git metadata of a remote service · Update git-metadata in remote service Entity #

Ask an LLM

“How do I repoint a remote service to a different repo or file path?”

“Can I change the connector used by a Git-stored service?”

Tell an agent

Update the git metadata of service {serviceIdentifier} to file {filePath} in repo {repoName}.

Switch remote service {serviceIdentifier} to connector {connectorRef}.

PUT /ng/api/servicesV2/upsert Create or update a service · Upsert a Service by identifier #

Ask an LLM

“Can I create a service if it doesn't exist and update it if it does?”

“Is there an upsert for services so I don't have to check first?”

Tell an agent

Upsert service {identifier} with YAML {yaml}.

Create or update service {identifier} named {name} in account {accountIdentifier}.

Harness Services API

Operations 17

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification