@adcp/sdk API Reference - v7.9.0
    Preparing search index...

    Interface SITerminateSessionRequest

    Request to terminate an SI session. Naturally idempotent — session_id is the dedup boundary, and terminating an already-terminated session is a no-op that returns the same terminal state. No idempotency_key is needed on this request.

    interface SITerminateSessionRequest {
        adcp_major_version?: number;
        session_id: string;
        reason:
            | "handoff_transaction"
            | "handoff_complete"
            | "user_exit"
            | "session_timeout"
            | "host_terminated";
        termination_context?: {
            summary?: string;
            transaction_intent?: { action?: "purchase"
            | "subscribe"; product?: {} };
            cause?: string;
        };
        context?: ContextObject;
        ext?: ExtensionObject;
    }
    Index

    Properties

    adcp_major_version? session_id reason termination_context? context? ext?

    Properties

    adcp_major_version?: number

    The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.

    1

    99

    session_id: string

    Session identifier to terminate

    reason:
        | "handoff_transaction"
        | "handoff_complete"
        | "user_exit"
        | "session_timeout"
        | "host_terminated"

    Reason for termination

    termination_context?: {
        summary?: string;
        transaction_intent?: { action?: "purchase" | "subscribe"; product?: {} };
        cause?: string;
    }

    Context for the termination

    Type Declaration

    • Optionalsummary?: string

      Summary of the conversation

    • Optionaltransaction_intent?: { action?: "purchase" | "subscribe"; product?: {} }

      For handoff_transaction - what user wants to buy

      • Optionalaction?: "purchase" | "subscribe"
      • Optionalproduct?: {}

        Product/service details

    • Optionalcause?: string

      For host_terminated - why host ended session

    context?: ContextObject
    ext?: ExtensionObject

    Settings

    Member Visibility

    On This Page

    Properties