dots.v2.agents.triggers.reusableSessions.get()

Generated on 5 Nov 2026 from DoTs version v1.23.0

Usage

client.v2.agents.triggers.reusableSessions.get(requestConfiguration?: RequestConfiguration<ReusableSessionsRequestBuilderGetQueryParameters>): Promise<undefined | List_reusable_sessions_response>

Description

Returns the team’s sessions in status PAUSED, for binding a session_mode=reuse trigger. The item shape is the hosted-agents Session, so agent_kind and status use the AGENT_KIND_* / SESSION_STATUS_* spelling; status is always SESSION_STATUS_PAUSED here.

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.

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.reusableSessions.get();

Response Example

Show Response Example
{
  "sessions": [
    {
      "session_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "demo-agent",
      "agent_kind": "AGENT_KIND_UNSPECIFIED",
      "status": "SESSION_STATUS_UNSPECIFIED",
      "created_at": "2026-07-27T12:00:00Z",
      "last_event_at": "2026-07-27T12:00:00Z"
    }
  ],
  "next_page_token": ""
}

More Information

See /v2/agents/triggers/reusable-sessions 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.