Request Models

Represents a container for one or more interactions in a session.

Contains a request with its associated interactions.

Groups multiple requests by session identifier.

Request model for getting requests grouped by session.

Response model for getting requests.

Request model for deleting a request and all its associated interactions.

Response model for request deletion requests.

Request model for deleting all requests in a session.

Response model for session deletion requests.

Records an optional external success, failure, or unknown outcome for an existing session. The server derives user_id and source from the earliest request ordered by (created_at, request_id); callers cannot override either field.

For a canonical row, an exact retry must match the caller payload, outcome contract, and canonical trajectory. It returns the same identity fields with success=true and recorded=false. A mismatch returns success=false, recorded=false, and reason="conflicting_finalization"; it does not replace the first outcome.

A rolling-upgrade row whose four identity fields are all null still compares the caller payload and any available server-derived session context, but it cannot compare the absent contract or trajectory digests. An accepted retry preserves all four identity fields as null. A changed payload or available session context returns conflicting_finalization.

All supplied filters combine with AND. Results use exact, case-sensitive matches and are ordered by occurred_at DESC, then user_id and session_id ascending.