Harness

Harness Spaces API

The Spaces API from Harness — 8 operation(s) for spaces.

GitHub OpenAPI

Operations 14

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 /har/api/v1/spaces/{space_ref}/artifact/stats Get artifact stats for a space · Get artifact stats #
Ask an LLM
“How many artifacts and downloads does a registry space have?”
“Can I see artifact statistics for a date range in a space?”
Tell an agent
Show artifact stats for space {space_ref}.
Get artifact stats in space {space_ref} from {from} to {to}.
GET /har/api/v1/spaces/{space_ref}/artifacts List artifacts across a space's registries · List artifacts #
Ask an LLM
“What artifacts are stored in the registries of this space?”
“Can I list only artifacts that have been deployed?”
Tell an agent
List all artifacts in space {space_ref}.
Search artifacts in space {space_ref} for {search_term} in registry {reg_identifier}.
GET /har/api/v1/spaces/{space_ref}/details Get storage usage for a space · Get storage details for given space #
Ask an LLM
“How much registry storage is a space using?”
“Where can I see the storage details for a space?”
Tell an agent
Show storage details for space {space_ref}.
How much storage is space {space_ref} consuming, give me the numbers.
GET /har/api/v1/spaces/{space_ref}/labels List labels defined in a space · Registrylist space labels #
Ask an LLM
“What labels are defined in this space?”
“Can I include labels inherited from parent spaces?”
Tell an agent
List labels in space {space_ref}.
List labels in space {space_ref} whose key contains {query}, including inherited ones: {inherited}.
POST /har/api/v1/spaces/{space_ref}/labels Define a new label in a space · Registrydefine space label #
Ask an LLM
“How do I define a new label key for a space?”
“Can a new label have a color and description?”
Tell an agent
Define label {key} in space {space_ref}.
Create label {key} colored {color} in space {space_ref} with description {description}.
PUT /har/api/v1/spaces/{space_ref}/labels Save a label and its values in a space · Registrysave space label #
Ask an LLM
“Can I create or overwrite a label together with its values in one call?”
“How do I save a full label definition including values for a space?”
Tell an agent
Save label {label} with values {values} in space {space_ref}.
Upsert a label and its values in space {space_ref}.
DELETE /har/api/v1/spaces/{space_ref}/labels/{key} Delete a label from a space · Registrydelete space label #
Ask an LLM
“How do I delete a label key from a space?”
“Is removing a space label permanent?”
Tell an agent destructive · confirm first
Delete label {key} from space {space_ref}.
Remove the {key} label in space {space_ref}.
GET /har/api/v1/spaces/{space_ref}/labels/{key} Get one label in a space · Find space label #
Ask an LLM
“What does a particular label in my space look like?”
“Can I fetch a label along with its allowed values?”
Tell an agent
Get label {key} in space {space_ref}.
Show label {key} in space {space_ref} including values: {include_values}.
PATCH /har/api/v1/spaces/{space_ref}/labels/{key} Update a label in a space · Registryupdate space label #
Ask an LLM
“Can I rename a label or change its color in a space?”
“How do I edit an existing space label's description?”
Tell an agent
Change label {key} in space {space_ref} to color {color}.
Update the description of label {key} in space {space_ref} to {description}.
GET /har/api/v1/spaces/{space_ref}/labels/{key}/values List the values of a space label · Registrylist space label values #
Ask an LLM
“Which values can a given label take in this space?”
“What values are defined under a label key?”
Tell an agent
List the values of label {key} in space {space_ref}.
Show allowed values for label {key} in {space_ref}.
POST /har/api/v1/spaces/{space_ref}/labels/{key}/values Add a value to a space label · Registrydefine space label value #
Ask an LLM
“How do I add a new allowed value to a label?”
“Can each label value have its own color?”
Tell an agent
Add value {value} to label {key} in space {space_ref}.
Define value {value} with color {color} under label {key} in space {space_ref}.
DELETE /har/api/v1/spaces/{space_ref}/labels/{key}/values/{value} Delete a value from a space label · Registrydelete space label value #
Ask an LLM
“How do I remove one value from a label without deleting the label?”
“Can I delete a single label value in a space?”
Tell an agent destructive · confirm first
Delete value {value} from label {key} in space {space_ref}.
Remove {value} as an option on label {key} in {space_ref}.
PATCH /har/api/v1/spaces/{space_ref}/labels/{key}/values/{value} Update a value of a space label · Registryupdate space label value #
Ask an LLM
“Can I rename or recolor a label value?”
“How do I edit one value under a space label?”
Tell an agent
Rename value {value} of label {key} in space {space_ref} to {new_value}.
Change the color of value {value} on label {key} in {space_ref} to {color}.
GET /har/api/v1/spaces/{space_ref}/registries List registries in a space · List registries #
Ask an LLM
“What artifact registries exist in this space?”
“Can I list only virtual or upstream registries of a package type?”
Tell an agent
List registries in space {space_ref}.
List {package_type} registries of type {type} in space {space_ref}.

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