Switch conversation ACP model
POST /api/v1/app-conversations/{conversation_id}/switch_acp_model
Switch the model of a running ACP conversation in place. Proxies to the agent-server's switch_acp_model endpoint, which issues a protocol-level session/set_model call to the ACP subprocess so the new model applies to subsequent turns without losing context. Persists the new model on the conversation record so the UI chip stays current.
Parameters
| Name | In | Type | Required | Description |
|---|
conversation_id | path | string | yes | — |
Request body
| Field | Type | Required | Description |
|---|
model | string | yes | Model identifier to switch to (must be supported by the provider). |
Responses
| Status | Description |
|---|
200 | Successful Response |
400 | Agent is not ACP, or provider does not support model switching |
404 | Conversation or sandbox not found |
409 | Sandbox is paused; resume it before switching models |
422 | Validation Error |
502 | Agent server returned an error |
504 | ACP server did not respond to the model switch in time |
Response body
| Field | Type | Required | Description |
|---|
success | boolean | no | — |
Operation ID: switch_conversation_acp_model_api_v1_app_conversations__conversation_id__switch_acp_model_post