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

Changes

Changed in 2 of the 107 revisions of this API.113

  • ad03d2ec1b20112See the full diff
    • removed the success response with the status 200

      response-success-status-removed

    • removed the request property note

      request-property-removed

    • added the new optional request property model

      new-optional-request-property

    • added the success response with the status 202

      response-success-status-added

    • endpoint added

      endpoint-added