dots.v2.agents.triggers.byTrigger_id().executions.get()

Generated on 5 Nov 2026 from DoTs version v1.23.0

Usage

client.v2.agents.triggers.byTrigger_id(trigger_id).executions.get(requestConfiguration?: RequestConfiguration<ExecutionsRequestBuilderGetQueryParameters>): Promise<undefined | List_trigger_executions_response>

Description

Keyset-paginated. The large payload field is omitted from list items; fetch a single execution to read it.

Parameters

Path Parameters

trigger_id string required

Example: b1a0c6de-1f2e-4a3b-9c8d-0e1f2a3b4c5d

The trigger UUID.

Query Parameters

pageSize integer optional

Example: 50

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

Min: 1

pageToken string optional

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

status string optional

Optional filter by execution status.

One of: pending, running, succeeded, failed

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.triggers
    .byTrigger_id("b1a0c6de-1f2e-4a3b-9c8d-0e1f2a3b4c5d").executions.get();

Response Example

Show Response Example
{
  "executions": [
    {
      "execution_id": "7c1f9e2a-3b4c-5d6e-7f80-91a2b3c4d5e6",
      "trigger_id": "b1a0c6de-1f2e-4a3b-9c8d-0e1f2a3b4c5d",
      "status": "succeeded",
      "session_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "run_id": "",
      "failure_reason": "",
      "created_at": "2026-07-27T12:00:00Z",
      "updated_at": "2026-07-27T12:00:05Z",
      "payload": "",
      "output_text": "",
      "output_truncated": false
    }
  ],
  "next_page_token": ""
}

More Information

See /v2/agents/triggers/{trigger_id}/executions 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.