dots.v2.agents.configs.post()

Generated on 5 Nov 2026 from DoTs version v1.23.0

Usage

client.v2.agents.configs.post(body: Agent_config_create_request, requestConfiguration?: RequestConfiguration<object>): Promise<undefined | Agent_config_response>

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

manifestYaml 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

Per-signal DigitalOcean Insights telemetry opt-in, mirroring the Insights-owned schema insights.telemetry.opt_in. Each signal is independently optional and tri-state: omitted or null records that the customer expressed no choice and falls back to the product default, which is NOT equivalent to false.

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 { FetchRequestAdapter } from "@microsoft/kiota-http-fetchlibrary";
import {
    createDigitalOceanClient,
    DigitalOceanApiKeyAuthenticationProvider,
} from "@digitalocean/dots";

const authProvider = new DigitalOceanApiKeyAuthenticationProvider(process.env.DIGITALOCEAN_TOKEN!);
const adapter = new FetchRequestAdapter(authProvider);
const client = createDigitalOceanClient(adapter);

const response = await client.v2.agents.configs.post({
    name: "support-agent",
    manifestYaml: "apiVersion: agents.digitalocean.com/v1alpha1\nkind: Agent\nspec:\n  runtime:\n    adapter: opencode\n",
    insights: {
        metrics: true,
        logs: true,
        traces: true,
    },
});

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": [],
    "region": "ric1"
  }
}

More Information

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

We can't find any results for your search.

Try using different keywords or simplifying your search terms.