For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).
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": ""
}
See /v2/agents/triggers/{trigger_id}/executions in the API reference for additional detail on responses, headers, parameters, and more.