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

# Update

> Reorder, hide or show cards and widgets in the session sidebar for the whole workspace.

The change applies to every agent. `card_order` and `hidden_cards` replace the stored lists, so read them with [Get layout](https://docs.open.cx/api-reference/session-sidebar/get.md) first and send the full list you want. Entries must be unique. To put a widget between built-in cards, give its `app:<mini app id>` entry that place in `card_order`.

```json theme={"dark"}
{ "card_order": ["session-tags", "app:<mini app id>", "contact"] }
```


## OpenAPI

````yaml put /session-sidebar
openapi: 3.1.0
info:
  title: OpenCX API
  description: >

    OpenCX is an AI-powered, all-in-one platform for customer support and
    outbound communications.


    Use this API to manage your OpenCX organization's AI agents, actions,
    conversations, contacts, and more.


    To get started, generate a new API key from the dashboard.


    ## Authentication

    All API endpoints require authentication using a Bearer token. You can
    generate an API key from your OpenCX dashboard.


    ## Rate Limiting

    API requests are rate limited to ensure fair usage. The current limits are:

    - 100 requests per minute for standard endpoints

    - 1000 requests per minute for streaming endpoints


    ## Error Handling

    The API uses standard HTTP status codes and returns detailed error messages
    in the response body.
  version: 1.0-beta
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
  - url: http://localhost:8080
    description: Development
  - url: https://api.open.cx
    description: Production
security:
  - bearerAuth: []
paths:
  /session-sidebar:
    put:
      tags:
        - Session sidebar
      summary: Update the session sidebar layout
      description: >-
        Reorder, hide or show cards and widgets in the session sidebar for the
        whole workspace. Partial update: omit a field to leave it unchanged.
        Returns the new layout.
      operationId: updateSessionSidebar
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateSessionSidebarDto'
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SessionSidebarDto'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
components:
  schemas:
    UpdateSessionSidebarDto:
      $schema: https://json-schema.org/draft/2020-12/schema
      $id: '#/components/schemas/UpdateSessionSidebarDtoInput'
      type: object
      properties:
        card_order:
          description: >-
            The new order, replacing the stored one. Entries are unique built-in
            card keys and `app:<mini app id>` entries.
          maxItems: 500
          type: array
          items:
            type: string
            minLength: 1
            maxLength: 200
        hidden_cards:
          description: The built-in card keys to hide, replacing the stored list.
          type: array
          items:
            type: string
    SessionSidebarDto:
      $schema: https://json-schema.org/draft/2020-12/schema
      $id: '#/components/schemas/SessionSidebarDto'
      type: object
      properties:
        card_order:
          type: array
          items:
            type: string
          description: >-
            Cards and widgets in the order the session sidebar shows them:
            built-in card keys and `app:<mini app id>` entries, one per mini-app
            widget. Empty means the default arrangement.
        hidden_cards:
          type: array
          items:
            type: string
          description: Built-in card keys hidden from the sidebar.
      required:
        - card_order
        - hidden_cards
      additionalProperties: false
    ErrorDto:
      type: object
      properties:
        statusCode:
          type: integer
        message:
          type: string
        error:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.