Sign in
Stateless Runs

Stateless Stream Run

Create a stateless run and stream its execution.

Generates an ephemeral thread, delegates to the threaded create_and_stream_run endpoint, and deletes the thread after the stream finishes (unless on_completion="keep").

post/runs/stream

Request body

assistant_idstring required

Assistant to execute

inputobject nullable

Input data for the run. Optional when resuming from a checkpoint.

configobject nullable

Execution config

contextobject nullable

Execution context

checkpointobject nullable

Checkpoint configuration (e.g., {'checkpoint_id': '...', 'checkpoint_ns': ''})

streamboolean

Enable streaming response

on_disconnectstring nullable

Behavior on client disconnect: 'cancel' (default) or 'continue'.

on_completion'delete' | 'keep' nullable

Behavior after stateless run completes: 'delete' (default) removes the ephemeral thread, 'keep' preserves it.

multitask_strategystring nullable

Strategy for handling concurrent runs on same thread: 'reject', 'interrupt', 'rollback', or 'enqueue'.

commandobject nullable

Command for resuming interrupted runs with state updates or navigation

stream_subgraphsboolean nullable

Whether to include subgraph events in streaming. When True, includes events from all subgraphs. When False (default when None), excludes subgraph events. Defaults to False for backwards compatibility.

metadataobject nullable

Request metadata propagated to OTEL trace attributes (langfuse.trace.metadata.<key>). Keys must match [A-Za-z0-9_-]{1,64}. Values must be primitive (str, int, float, bool); string values are capped at 512 characters. Maximum 32 keys. Use this for filterable attributes (tenant, feature flag, environment, sub-agent type) rather than payload data.

Response

Server-Sent Events stream

{"stackTrail":"paths:/runs/stream:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes

Changed in 2 of the 53 revisions of this API.3

  • f2396b21b7b52See the full diff
    • ○

      the config request property default value {} was removed

      request-property-default-value-removed

    • ○

      the context request property default value {} was removed

      request-property-default-value-removed

  • 7c41348cb28f1See the full diff
    • ○

      endpoint added

      endpoint-added