v1
latestOpenAPI 3.1.02026-07-26142186376.1 KBAgents
Fork Agent Session
Deep-copy a session into a new independent session. Every run is copied with a fresh run_id; the new session has a fresh session_id. The original is untouched. Use to explore alternative conversation paths without mutating the source.
Distinct from /continue?fork=true: that creates a sibling run inside the same session. This creates a sibling session.
post/agents/{agent_id}/sessions/{session_id}/fork
Path parameters
agent_idstring required
session_idstring required
Query parameters
user_idstring nullable
Response
Session forked successfully
{"stackTrail":"paths:/agents/{agent_id}/sessions/{session_id}/fork:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}