Skip to content
OpenCode
Esc
navigateopen⌘Jpreview

Switch session agent

Switch the agent used by subsequent provider turns.

POST/api/session/{sessionID}/agent
Path parameters
sessionIDobjectrequired
Request body
requiredapplication/json
agentstringrequired
Responses
204<No Content>
400InvalidRequestError
_tagstringrequired
Allowed:InvalidRequestError
messagestringrequired
kindstring | any
Show properties
Any of:
string
string
any
any
fieldstring | any
Show properties
Any of:
string
string
any
any
401UnauthorizedError
_tagstringrequired
Allowed:UnauthorizedError
messagestringrequired
404SessionNotFoundError
Any of:
SessionNotFoundError
_tagstringrequired
Allowed:SessionNotFoundError
sessionIDstringrequired
messagestringrequired
SessionNotFoundError
_tagstringrequired
Allowed:SessionNotFoundError
sessionIDstringrequired
messagestringrequired
Request
curl -X POST "/api/session/%5Bobject%20Object%5D/agent" \
  -H "Content-Type: application/json" \
  -d '{
  "agent": "string"
}'
Response
<No Content>