OpenAPI 3.1.0raw.githubusercontent.com2026-08-16113193225.3 KB

3ae641945d05

sessions

Switch a logical AO session to another agent harness

post/api/v1/sessions/{sessionId}/switch-agent

Path parameters

sessionIdstring required

Session identifier, e.g. project-1.

Session identifier, e.g. project-1.

Request body

idempotencyKeystring

Optional retry key. Reusing it with a different request is rejected.

modelstring

Optional model override for the target agent launch or resume.

targetHarness'claude-code' | 'codex' required

Agent harness to continue the logical AO session with.

Response

Accepted