---
title: DigitalOcean Harness Runtime Reference (public)
description: Environment spec reference and links to API and doctl resources for Harness Runtime.
product: Managed Agents
url: https://docs.digitalocean.com/products/managed-agents/agent-harness-runtime/reference/
last_updated: "2026-09-21"
---

> **For AI agents:** The documentation index is at [https://docs.digitalocean.com/llms.txt](https://docs.digitalocean.com/llms.txt). Markdown versions of pages use the same URL with `index.html.md` in place of the HTML page (for example, append `index.html.md` to the directory path instead of opening the HTML document).

# DigitalOcean Harness Runtime Reference (public)

DigitalOcean Harness Runtime combines the functionality of a lightweight microVM, built-in tools like chromium and a coding sandbox needed by agents to do work. The product offers rich lifecycle APIs that persist conversational history and working state across sessions, with pause/resume/fork semantics so that developers can control costs and adapt workflows to the nonlinear quirks of agentic work. See [What You Can Build](https://docs.digitalocean.com/products/managed-agents/agent-harness-runtime/details/what-you-can-build/index.html.md) for example use cases.

## Additional Tools for Harness Runtime

### The DigitalOcean API

The [DigitalOcean API](https://docs.digitalocean.com/reference/index.html.md) lets you manage resources programmatically with standard HTTP requests. All actions available in the control panel are also available through the API.

Harness Runtime session and configuration endpoints are under `/v2/agents/*`. See the [API documentation](https://docs.digitalocean.com/reference/api/index.html.md) for authentication and request format.

### The DigitalOcean Command Line Client, doctl

[`doctl`](https://github.com/digitalocean/doctl) is the command-line interface for the DigitalOcean API. It supports most of the same actions available in the API and DigitalOcean Control Panel.

Harness Runtime commands live under `doctl harness-runtime`. See the [`doctl` documentation](https://docs.digitalocean.com/reference/doctl/index.html.md) or use `doctl harness-runtime --help` for more information.

[Environment Spec Reference](https://docs.digitalocean.com/products/managed-agents/agent-harness-runtime/reference/environment-spec/index.html.md): Field reference for the YAML environment specification, covering the adapter, sandbox, credentials, egress, tools, skills, and permission fields.