Switch conversation profile
POST /api/v1/app-conversations/{conversation_id}/switch_profile
Switch the running conversation's LLM to a saved profile. Profiles live in the app-server's user settings, not on the sandbox FS, so we resolve the profile here and hand the LLM directly to the agent-server's switch_llm endpoint.
Parameters
| Name | In | Type | Required | Description |
|---|
conversation_id | path | string | yes | — |
Request body
| Field | Type | Required | Description |
|---|
profile_name | string | yes | Name of a profile previously saved via /api/v1/settings/profiles. |
Responses
| Status | Description |
|---|
200 | Successful Response |
404 | Conversation, sandbox, or profile not found |
409 | Sandbox is not running |
422 | Validation Error |
502 | Agent server returned an error |
Response body
| Field | Type | Required | Description |
|---|
success | boolean | no | — |
Operation ID: switch_conversation_profile_api_v1_app_conversations__conversation_id__switch_profile_post