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

# Switch the active account



## OpenAPI

````yaml /openapi/v3.yaml post /api/v2/accounts/switch
openapi: 3.1.0
info:
  title: Semicola Exchange API
  version: 3.0.0-preview
  description: >-
    Platform endpoints of Semicola: sign-in and accounts, members and keys,
    billing, notifications, the Semi assistant (chat stream, confirmations,
    conversations), the MCP App widget host and realtime feeds. Typed agent
    tools live on the MCP server at /mcp/v3.
servers:
  - url: https://api.semicola.com
security:
  - bearerAuth: []
  - sessionCookie: []
tags:
  - name: Auth
  - name: Accounts
  - name: Billing
  - name: Notifications
  - name: Assistant
  - name: Widget host
  - name: Realtime
  - name: Demo
paths:
  /api/v2/accounts/switch:
    post:
      tags:
        - Accounts
      summary: Switch the active account
      operationId: postAccountsSwitch
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                customerId:
                  type: integer
                  exclusiveMinimum: 0
                  maximum: 9007199254740991
              required:
                - customerId
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    anyOf:
                      - type: object
                        properties:
                          currentCustomerId:
                            type: integer
                            exclusiveMinimum: 0
                            maximum: 9007199254740991
                          customer:
                            type: object
                            properties:
                              id:
                                type: integer
                                exclusiveMinimum: 0
                                maximum: 9007199254740991
                              name:
                                type: string
                              company:
                                type:
                                  - string
                                  - 'null'
                              kind:
                                type: string
                                enum:
                                  - STANDALONE
                                  - PARENT
                                  - CHILD
                              nodeKind:
                                type: string
                                enum:
                                  - ACCOUNT
                                  - CONTAINER
                              accountType:
                                anyOf:
                                  - type: string
                                    enum:
                                      - BUYER
                                      - SELLER
                                      - PARTNER
                                  - type: 'null'
                              role:
                                type: string
                                enum:
                                  - SUPER_ADMIN
                                  - ADMIN
                                  - PREMIUM
                                  - BASIC
                              membershipRole:
                                type: string
                                enum:
                                  - MEMBER
                                  - ADMIN
                              parentId:
                                anyOf:
                                  - type: integer
                                    exclusiveMinimum: 0
                                    maximum: 9007199254740991
                                  - type: 'null'
                              buyerAccessPosture:
                                anyOf:
                                  - type: string
                                    enum:
                                      - SANDBOX_ONLY
                                      - LIVE_ELIGIBLE
                                  - type: 'null'
                            required:
                              - id
                              - name
                              - company
                              - kind
                              - nodeKind
                              - accountType
                              - role
                              - membershipRole
                              - parentId
                              - buyerAccessPosture
                            additionalProperties: false
                        required:
                          - currentCustomerId
                          - customer
                        additionalProperties: false
                      - type: 'null'
                  error:
                    anyOf:
                      - type: object
                        properties:
                          code:
                            type: string
                          message:
                            type: string
                          field:
                            type: string
                          details: {}
                        required:
                          - code
                          - message
                        additionalProperties: false
                      - type: 'null'
                required:
                  - data
                  - error
                additionalProperties: false
        default:
          description: >-
            Error envelope `{data: null, error: {code, message, field?,
            details?}}`.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key or OAuth access token.
    sessionCookie:
      type: apiKey
      in: cookie
      name: sc_session

````