> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openhands.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Switch Conversation 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.



## OpenAPI

````yaml /openapi/openhands-cloud.json post /api/v1/app-conversations/{conversation_id}/switch_acp_model
openapi: 3.1.0
info:
  title: OpenHands
  description: 'OpenHands: Code Less, Make More'
  version: 0.0.1
servers: []
security: []
paths:
  /api/v1/app-conversations/{conversation_id}/switch_acp_model:
    post:
      tags:
        - Conversations
      summary: Switch Conversation Acp Model
      description: >-
        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.
      operationId: >-
        switch_conversation_acp_model_api_v1_app_conversations__conversation_id__switch_acp_model_post
      parameters:
        - name: conversation_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Conversation Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SwitchAcpModelRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Success'
        '400':
          description: Agent is not ACP, or provider does not support model switching
        '404':
          description: Conversation or sandbox not found
        '409':
          description: Sandbox is paused; resume it before switching models
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '502':
          description: Agent server returned an error
        '504':
          description: ACP server did not respond to the model switch in time
      security:
        - APIKeyHeader: []
components:
  schemas:
    SwitchAcpModelRequest:
      properties:
        model:
          type: string
          minLength: 1
          title: Model
          description: Model identifier to switch to (must be supported by the provider).
      type: object
      required:
        - model
      title: SwitchAcpModelRequest
      description: Request to switch a running ACP conversation's model in place.
    Success:
      properties:
        success:
          type: boolean
          title: Success
          default: true
      type: object
      title: Success
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-Access-Token

````