latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-21119202241.3 KB

ddec88a09a83

sessions

Submit a generation-fenced source-agent handoff

post/api/v1/sessions/{sessionId}/agent-switches/{switchId}/handoff

Path parameters

sessionIdstring required

Session identifier, e.g. project-1.

Session identifier, e.g. project-1.

switchIdstring required

Durable agent-switch identifier.

Durable agent-switch identifier.

Request body

{"stackTrail":"components:schemas:SubmitAgentHandoffRequest:properties:handoff","oasType":"schema","type":"unknown","description":"Structured, source-agent-authored handoff enrichment."}
sourceGenerationIdstring required

Source invocation generation that authored this handoff.

Response

OK