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

5682a5de7409

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