Give Feedback

pydo.harness.create_config()

Generated on 16 Oct 2026 from pydo version v0.44.0

Copy page as Markdown View page as Markdown

Usage

client.harness.create_config(
    body={
        "name": "support-agent",
        "manifest_yaml": "{your_manifest_yaml}",
        "insights": {...},
    },
)

Returns JSON Raises HttpResponseError

Description

Accepts name, environment-spec YAML text, and optional Insights telemetry opt-in. Tenant secrets are declared inside the environment spec (write-only values), not as sibling request fields. Responses never echo secret values; GET/create may include credential slot metadata (name/source/provider only). Configs are immutable after create.

Parameters

name string required

Example: support-agent

Config name, case-insensitively unique among the team's active configs.

Min length: 1

Max length: 64

manifest_yaml string required

Example: apiVersion: agents.digitalocean.com/v1alpha1 kind: Agent spec: runtime: adapter: opencode

Customer environment-spec YAML text. The HTTP JSON body is capped at 1 MiB and this field is capped at 512 KiB.

Max length: 524288

insights object optional

Show child properties

metrics boolean or null optional: Accepted and stored for parity with the Insights schema, but metrics are always collected: unregistered metrics are dropped at ingest rather than opted out of here.
logs boolean or null optional: Whether the agent's logs are sent to Insights.
traces boolean or null optional: Whether the agent's traces are sent to Insights.

Request Sample

Show Request Sample

import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

req = {
  "name": "support-agent",
  "manifest_yaml": "apiVersion: agents.digitalocean.com/v1alpha1\nkind: Agent\nspec:\n  runtime:\n    adapter: opencode\n",
  "insights": {
    "metrics": True,
    "logs": True,
    "traces": True
  }
}

resp = client.harness.create_config(body=req)

Response Example

Show Response Example

{
  "config": {
    "id": "019fb39c-14d9-7080-933e-b9b90e25acda",
    "name": "support-agent",
    "agentspec_schema_version": "agents.digitalocean.com/v1alpha1",
    "content_hash": "75803fef24dc731824ecd4a1853c76153c7d8503534092b94da3ca3f31a882f4",
    "created_by": "user-1",
    "created_at": "2026-08-01T12:00:00Z",
    "updated_at": "2026-08-01T12:00:00Z",
    "credentials": []
  }
}

More Information

See /v2/agents/configs in the API reference for additional detail on responses, headers, parameters, and more.