Give Feedback

pydo.harness.list_triggers()

Generated on 16 Oct 2026 from pydo version v0.44.0

Copy page as Markdown View page as Markdown

Usage

client.harness.list_triggers(
    page_size=None,
    page_token=None,
    kind=None,
    status=None,
)

Returns JSON Raises HttpResponseError

Description

Keyset-paginated on an opaque cursor. Excludes soft-deleted triggers. Scoped to the authenticated team.

Parameters

page_size integer optional

Example: 50

Page size. Defaults to 50 when omitted or non-positive; server-clamped.

Min: 1

page_token string optional

Opaque keyset cursor returned by the previous page. Empty starts from the beginning.

kind string optional

Optional filter by trigger kind.

One of: webhook, cron

status string optional

Optional filter by trigger status.

One of: active, paused

Response Example

Show Response Example

{
  "triggers": [
    {
      "trigger_id": "b1a0c6de-1f2e-4a3b-9c8d-0e1f2a3b4c5d",
      "kind": "webhook",
      "name": "nightly-deploy-check",
      "status": "active",
      "session_mode": "fresh",
      "agent_kind": "AGENT_KIND_UNSPECIFIED",
      "prompt_template": "Review the latest push and summarize risks.",
      "session_template": "",
      "bound_session_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "created_at": "2026-07-27T12:00:00Z",
      "updated_at": "2026-07-27T12:00:00Z"
    }
  ],
  "next_page_token": ""
}

More Information

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