dots.v2.agents.triggers.bySession.bySession_id().get()

Generated on 13 Nov 2026 from DoTs version v1.24.0

Usage

client.v2.agents.triggers.bySession.bySession_id(session_id).get(requestConfiguration?: RequestConfiguration<object>): Promise<undefined | Get_trigger_response>

Description

Returns the trigger that produced (fresh) or binds (reuse) the given session. Resolves to the row even after the trigger is soft-deleted.

Parameters

session_id string required

Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

The session UUID.

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.bySession
    .bySession_id("a1b2c3d4-e5f6-7890-abcd-ef1234567890").get();

Response Example

Show Response Example
{
  "trigger": {
    "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.",
    "output": {
      "mode": "email",
      "email_configured": true,
      "slack_configured": false
    },
    "session_template": "",
    "bound_session_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "webhook": {
      "provider": "github",
      "webhook_url": "https://api.digitalocean.com/v2/agents/triggers/b1a0.../webhook"
    },
    "cron": {
      "cron_expr": "0 9 * * 1-5",
      "timezone": "America/New_York",
      "next_run_at": "2026-07-27T13:00:00Z"
    },
    "created_at": "2026-07-27T12:00:00Z",
    "updated_at": "2026-07-27T12:00:00Z"
  }
}

More Information

See /v2/agents/triggers/by-session/{session_id} 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.