pydo.harness.list_configs()

Generated on 13 Nov 2026 from pydo version v0.46.0

Usage

client.harness.list_configs(
    page_size=50,
    page_token=None,
    search=None,
)
Returns JSON Raises HttpResponseError

Description

Returns lightweight team-scoped config metadata without loading or returning environment-spec JSON. Soft-deleted configs are excluded.

Parameters

page_size integer optional

Example: 50

Page size. Defaults to 50 when omitted. Values above 200 are rejected.

Min: 1

Max: 200

Default: 50

page_token string optional

Opaque keyset cursor returned by the previous page.

search string optional

Example: support

Optional case-insensitive substring filter on config name (contains). Empty or omitted returns the unfiltered page. At most 64 characters.

Max length: 64

Response Example

Show Response Example
{
  "configs": [
    {
      "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",
      "region": "ric1"
    }
  ],
  "next_page_token": ""
}

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.